Ajouter un contact à une audience
Prend une adresse déjà présente dans le carnet de l'espace de travail et renvoie l'appartenance, avec le contact qu'elle désigne. Il y a une seule appartenance par audience et par contact : ajouter quelqu'un qui se trouve déjà dans l'audience répond donc `200` avec le `addedAt` d'origine, plutôt que d'en ajouter une seconde ou d'échouer. L'appel peut ainsi être réessayé sans risque.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
POST /audiences/{id}/contacts
Prend une adresse déjà présente dans le carnet de l'espace de travail et renvoie l'appartenance, avec le contact qu'elle désigne. Il y a une seule appartenance par audience et par contact : ajouter quelqu'un qui se trouve déjà dans l'audience répond donc 200 avec le addedAt d'origine, plutôt que d'en ajouter une seconde ou d'échouer. L'appel peut ainsi être réessayé sans risque.
Exemple
Nécessite audiences:write.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{ "email": "[email protected]"}'{ "object": "audience_member", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "addedAt": "2026-09-18T09:30:00.000Z", "contact": { "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" }}Une adresse qui n'est pas un contact est refusée avec 422 contact_not_found plutôt que créée au passage. Enregistrez-la d'abord avec POST /contacts.
audiences:write est la seule portée vérifiée. Placer un contact dans une liste n'est pas une écriture sur le contact.
Un appel par contact. Il n'y a pas d'ajout en masse dans cette version, et supprimer le contact plus tard emporte cette appartenance avec lui.