Назначение аудиторий контакта
Точно задаёт одним вызовом, в каких аудиториях состоит контакт. Контакт вступает в каждую аудиторию из `audienceIds`, в которой его ещё нет, и выходит из всех остальных. Аудитория по умолчанию сохраняется всегда, поэтому пустой список оставляет контакт только в аудитории по умолчанию.
Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.
PUT /contacts/{email}/audiences
Точно задаёт одним вызовом, в каких аудиториях состоит контакт. Контакт вступает в каждую аудиторию из audienceIds, в которой его ещё нет, и выходит из всех остальных. Аудитория по умолчанию сохраняется всегда, поэтому пустой список оставляет контакт только в аудитории по умолчанию.
Пример
Требует audiences:write, потому что записывает членство, а не сам контакт. Закодируйте @ в URL. audienceIds вмещает до 100 идентификаторов.
curl -X PUT "$OE/contacts/grace%40example.com/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{ "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"]}'{ "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", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }, { "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "builtin": null } ]}Контакт уже должен существовать. Адрес, которого нет в книге, даёт 404 contact_not_found. Создайте его через POST /contacts, который тоже принимает audienceIds.
Идентификатор, не соответствующий ни одной аудитории этого рабочего пространства, даёт 404 audience_not_found, и ничего не меняется, так что опечатка не может незаметно убрать человека из списка. Повторный такой же вызов ничего не меняет.
Ответ — это контакт в том виде, в каком его возвращает GET /contacts/{email}, со всеми аудиториями, в которых он состоит после изменения.