API

Bir kitleye kişi ekleme

Çalışma alanı defterinde zaten bulunan bir adresi alır ve üyeliği, işaret ettiği kişiyle birlikte döndürür. Her kitle ve kişi için tek bir üyelik vardır; bu yüzden kitlede zaten bulunan birini eklemek, ikinci bir üyelik oluşturmak ya da hata vermek yerine özgün `addedAt` değeriyle `200` yanıtı verir. Bu da çağrıyı yeniden denemeyi güvenli kılar.

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

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

POST /audiences/{id}/contacts

Çalışma alanı defterinde zaten bulunan bir adresi alır ve üyeliği, işaret ettiği kişiyle birlikte döndürür. Her kitle ve kişi için tek bir üyelik vardır; bu yüzden kitlede zaten bulunan birini eklemek, ikinci bir üyelik oluşturmak ya da hata vermek yerine özgün addedAt değeriyle 200 yanıtı verir. Bu da çağrıyı yeniden denemeyi güvenli kılar.

Örnek

audiences:write gerektirir.

curl

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

Yanıt

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

Kişi olmayan bir adres, o anda oluşturulmak yerine 422 contact_not_found ile reddedilir. Önce POST /contacts ile kaydedin.

Denetlenen tek kapsam audiences:write. Bir kişiyi listeye koymak, kişinin kendisine yazmak sayılmaz.

Kişi başına bir çağrı. Bu sürümde toplu ekleme yoktur; kişiyi sonradan silmek bu üyeliği de beraberinde götürür.