API

Névjegy hozzáadása közönséghez

Olyan címet vesz át, amely már szerepel a munkaterület címjegyzékében, és visszaadja a tagságot a hozzá tartozó névjeggyel együtt. Közönségenként és névjegyenként egyetlen tagság létezik, ezért ha valaki már a közönségben van, a hívás `200` választ ad az eredeti `addedAt` értékkel, ahelyett hogy másodszor is felvenné vagy hibára futna. Ettől a hívás biztonságosan megismételhető.

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

A valódi hívást futtatja le a munkaterületén, a saját kulcsával.

POST /audiences/{id}/contacts

Olyan címet vesz át, amely már szerepel a munkaterület címjegyzékében, és visszaadja a tagságot a hozzá tartozó névjeggyel együtt. Közönségenként és névjegyenként egyetlen tagság létezik, ezért ha valaki már a közönségben van, a hívás 200 választ ad az eredeti addedAt értékkel, ahelyett hogy másodszor is felvenné vagy hibára futna. Ettől a hívás biztonságosan megismételhető.

Példa

audiences:write szükséges hozzá.

curl

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

Válasz

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

Az olyan címet, amely nem névjegy, 422 contact_not_found hibával utasítja el, ahelyett hogy helyben létrehozná. Előbb mentsd el a POST /contacts hívással.

Csak az audiences:write hatókört ellenőrzi. Egy névjegy listába tétele nem írja magát a névjegyet.

Névjegyenként egy hívás. Ebben a verzióban nincs tömeges hozzáadás, és ha később törlöd a névjegyet, ez a tagság is megszűnik vele.