API

Добавление контакта в аудиторию

Принимает адрес, уже имеющийся в адресной книге рабочего пространства, и возвращает запись о членстве вместе с контактом, на который она указывает. На каждую пару аудитории и контакта приходится одна запись о членстве, поэтому добавление того, кто уже есть в аудитории, отвечает `200` с исходным `addedAt`, а не создаёт вторую запись и не завершается ошибкой. Благодаря этому вызов безопасно повторять.

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

Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.

POST /audiences/{id}/contacts

Принимает адрес, уже имеющийся в адресной книге рабочего пространства, и возвращает запись о членстве вместе с контактом, на который она указывает. На каждую пару аудитории и контакта приходится одна запись о членстве, поэтому добавление того, кто уже есть в аудитории, отвечает 200 с исходным addedAt, а не создаёт вторую запись и не завершается ошибкой. Благодаря этому вызов безопасно повторять.

Пример

Требуется audiences:write.

curl

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

Ответ

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

Адрес, который не является контактом, отклоняется с 422 contact_not_found, а не создаётся на месте. Сначала сохраните его через POST /contacts.

audiences:write — единственный проверяемый scope. Помещение контакта в список не является записью в сам контакт.

Один вызов на контакт. Массового добавления в этой версии нет, а удаление контакта впоследствии убирает вместе с ним и это членство.