Перейти к документации
API

Создание аудитории

Создаёт новую пустую аудиторию и возвращает её вместе с id. `name` обрезается по краям и после этого должно быть длиной от 1 до 120 символов. `description` — необязательный произвольный текст для того, кто будет читать список позже. Имена не проверяются на дубликаты, потому что к аудитории обращаются по её id.

POSTapi.openemail.uk/audiences

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

POST /audiences

Создаёт новую пустую аудиторию и возвращает её вместе с id. name обрезается по краям и после этого должно быть длиной от 1 до 120 символов. description — необязательный произвольный текст для того, кто будет читать список позже. Имена не проверяются на дубликаты, потому что к аудитории обращаются по её id.

Пример

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

curl
curl -X POST "$OE/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Product updates",  "description": "Customers who asked to hear about releases"}'
Ответ
{  "object": "audience",  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",  "name": "Product updates",  "description": "Customers who asked to hear about releases",  "builtin": null,  "contactCount": 0,  "createdAt": "2026-09-18T09:10:00.000Z",  "updatedAt": "2026-09-18T09:10:00.000Z"}

builtin никогда не принимается из тела запроса. Ровно одна запись на рабочее пространство несёт его, и этой записью владеет сервер.

Рабочее пространство содержит не более 100 аудиторий. Следующая отклоняется с 422 audience_limit_reached по полю name.

Наполняйте её маршрутом добавления, по одному контакту за раз, и контакты уже должны быть в книге.