API

Pievienot kontaktu auditorijai

Pieņem adresi, kas jau ir darbvietas grāmatā, un atgriež dalību kopā ar kontaktu, uz kuru tā norāda. Uz vienu auditoriju un kontaktu ir viena dalība, tāpēc tāda cilvēka pievienošana, kurš auditorijā jau ir, atbild ar `200` un sākotnējo `addedAt`, nevis pievieno otru ierakstu vai neizdodas. Tāpēc izsaukumu ir droši atkārtot.

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

Izpilda īstu izsaukumu pret jūsu darbvietu, ar jūsu paša atslēgu.

POST /audiences/{id}/contacts

Pieņem adresi, kas jau ir darbvietas grāmatā, un atgriež dalību kopā ar kontaktu, uz kuru tā norāda. Uz vienu auditoriju un kontaktu ir viena dalība, tāpēc tāda cilvēka pievienošana, kurš auditorijā jau ir, atbild ar 200 un sākotnējo addedAt, nevis pievieno otru ierakstu vai neizdodas. Tāpēc izsaukumu ir droši atkārtot.

Piemērs

Nepieciešams audiences:write.

curl

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

Atbilde

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

Adrese, kas nav kontakts, tiek noraidīta ar 422 contact_not_found, nevis izveidota turpat uz vietas. Vispirms saglabājiet to ar POST /contacts.

audiences:write ir vienīgais pārbaudītais tvērums. Kontakta ievietošana sarakstā nav rakstīšana pašā kontaktā.

Viens izsaukums uz vienu kontaktu. Šajā versijā nav masveida pievienošanas, un kontakta dzēšana vēlāk noņem līdzi arī šo dalību.