API

Een contact aan een audience toevoegen

Neemt een adres dat al in het adresboek van de workspace staat en geeft het lidmaatschap terug, samen met het contact waar het naar verwijst. Er is één lidmaatschap per audience en contact, dus iemand toevoegen die al in de audience zit antwoordt met `200` en de oorspronkelijke `addedAt`, in plaats van een tweede toe te voegen of te falen. Daardoor kun je de aanroep veilig opnieuw proberen.

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

Voert de echte aanroep uit op je workspace, met je eigen sleutel.

POST /audiences/{id}/contacts

Neemt een adres dat al in het adresboek van de workspace staat en geeft het lidmaatschap terug, samen met het contact waar het naar verwijst. Er is één lidmaatschap per audience en contact, dus iemand toevoegen die al in de audience zit antwoordt met 200 en de oorspronkelijke addedAt, in plaats van een tweede toe te voegen of te falen. Daardoor kun je de aanroep veilig opnieuw proberen.

Voorbeeld

Vereist audiences:write.

curl

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

Antwoord

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

Een adres dat geen contact is, wordt geweigerd met 422 contact_not_found in plaats van ter plekke aangemaakt. Sla het eerst op met POST /contacts.

audiences:write is de enige scope die wordt gecontroleerd. Een contact in een lijst zetten is geen schrijfactie op het contact.

Eén aanroep per contact. Er is in deze versie geen bulktoevoeging, en het contact later verwijderen laat dit lidmaatschap mee vervallen.