API

Afegir un contacte a una audiència

Pren una adreça que ja és a la llibreta de l'espai de treball i retorna la pertinença, amb el contacte al qual apunta. Hi ha una sola pertinença per audiència i contacte, de manera que afegir algú que ja és a l'audiència respon `200` amb l'`addedAt` original en comptes d'afegir-ne una segona o fallar. Això fa que la crida es pugui reintentar sense perill.

POSTapi.openemail.uk/audiences/{id}/contacts

Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.

POST /audiences/{id}/contacts

Pren una adreça que ja és a la llibreta de l'espai de treball i retorna la pertinença, amb el contacte al qual apunta. Hi ha una sola pertinença per audiència i contacte, de manera que afegir algú que ja és a l'audiència respon 200 amb l'addedAt original en comptes d'afegir-ne una segona o fallar. Això fa que la crida es pugui reintentar sense perill.

Exemple

Requereix audiences:write.

curl

curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{  "email": "[email protected]"}'

Resposta

{  "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"  }}

Una adreça que no és un contacte es rebutja amb 422 contact_not_found en comptes de crear-se sobre la marxa. Desa-la abans amb POST /contacts.

audiences:write és l'únic àmbit que es comprova. Posar un contacte en una llista no és una escriptura sobre el contacte.

Una crida per contacte. En aquesta versió no hi ha alta massiva, i eliminar el contacte més endavant se'n emporta aquesta pertinença.