API

Shtoni një kontakt në një audiencë

Merr një adresë që ndodhet tashmë në librin e adresave të hapësirës së punës dhe kthen anëtarësimin, bashkë me kontaktin te i cili tregon. Ka një anëtarësim të vetëm për çdo çift audience–kontakt, prandaj shtimi i dikujt që ndodhet tashmë në audiencë përgjigjet me `200` dhe me `addedAt` origjinal, në vend që të shtojë një të dytë ose të dështojë. Kjo e bën thirrjen të sigurt për riprovim.

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

Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.

POST /audiences/{id}/contacts

Merr një adresë që ndodhet tashmë në librin e adresave të hapësirës së punës dhe kthen anëtarësimin, bashkë me kontaktin te i cili tregon. Ka një anëtarësim të vetëm për çdo çift audience–kontakt, prandaj shtimi i dikujt që ndodhet tashmë në audiencë përgjigjet me 200 dhe me addedAt origjinal, në vend që të shtojë një të dytë ose të dështojë. Kjo e bën thirrjen të sigurt për riprovim.

Shembull

Kërkon audiences:write.

curl

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

Përgjigje

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

Një adresë që nuk është kontakt refuzohet me 422 contact_not_found, në vend që të krijohet aty për aty. Ruajeni më parë me POST /contacts.

audiences:write është i vetmi fushëveprim që kontrollohet. Vendosja e një kontakti në një listë nuk është shkrim mbi vetë kontaktin.

Një thirrje për çdo kontakt. Në këtë version nuk ka shtim në masë dhe fshirja e kontaktit më vonë e heq edhe këtë anëtarësim bashkë me të.