Définir les audiences d'un contact
Dit exactement dans quelles audiences se trouve un contact, en un seul appel. Le contact rejoint chaque audience de `audienceIds` où il n'est pas encore et quitte toutes les autres. L'audience par défaut est toujours conservée : une liste vide laisse donc le contact dans la seule audience par défaut.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
PUT /contacts/{email}/audiences
Dit exactement dans quelles audiences se trouve un contact, en un seul appel. Le contact rejoint chaque audience de audienceIds où il n'est pas encore et quitte toutes les autres. L'audience par défaut est toujours conservée : une liste vide laisse donc le contact dans la seule audience par défaut.
Exemple
Nécessite audiences:write, car l'appel écrit des appartenances et non le contact. Encodez le @ dans l'URL. audienceIds contient jusqu'à 100 identifiants.
curl -X PUT "$OE/contacts/grace%40example.com/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{ "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"]}'{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": null, "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-18T09:00:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }, { "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "builtin": null } ]}Le contact doit déjà exister. Une adresse absente du carnet donne un 404 contact_not_found. Créez-le avec POST /contacts, qui accepte aussi audienceIds.
Un identifiant qui ne désigne aucune audience de cet espace de travail donne un 404 audience_not_found et rien ne change : une faute de frappe ne peut donc pas retirer quelqu'un d'une liste en silence. Renvoyer le même appel ne change rien.
La réponse est le contact tel que GET /contacts/{email} le renvoie, avec chaque audience dont il fait partie après le changement.