API

Přidání kontaktu do publika

Přijme adresu, která už je v adresáři workspace, a vrátí členství spolu s kontaktem, na který ukazuje. Na každou dvojici publikum a kontakt připadá jedno členství, takže přidání někoho, kdo už v publiku je, odpoví `200` s původním `addedAt`, místo aby přidalo druhé členství nebo selhalo. Volání je díky tomu bezpečné opakovat.

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

Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.

POST /audiences/{id}/contacts

Přijme adresu, která už je v adresáři workspace, a vrátí členství spolu s kontaktem, na který ukazuje. Na každou dvojici publikum a kontakt připadá jedno členství, takže přidání někoho, kdo už v publiku je, odpoví 200 s původním addedAt, místo aby přidalo druhé členství nebo selhalo. Volání je díky tomu bezpečné opakovat.

Příklad

Vyžaduje audiences:write.

curl

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

Odpověď

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

Adresa, která není kontaktem, se odmítne s 422 contact_not_found a nevytvoří se na místě. Nejprve ji uložte přes POST /contacts.

Kontroluje se jediný scope, audiences:write. Zařazení kontaktu do seznamu není zápisem do kontaktu.

Jedno volání na kontakt. V této verzi neexistuje hromadné přidání a pozdější smazání kontaktu odstraní i toto členství.