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

Список аудиторий

Аудитория — это именованный список контактов в этом рабочем пространстве. Каждый контакт с момента появления входит во встроенную аудиторию по умолчанию, и именно `builtin` обозначает эту запись; остальные аудитории вы создаёте, наполняете и удаляете сами. Аудитория по умолчанию идёт первой, затем остальные — от новых к старым. Эта версия управляет списками и ничего им не отправляет, поэтому искать эндпоинт для массовой рассылки бессмысленно.

GETapi.openemail.uk/audiences

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

GET /audiences

Аудитория — это именованный список контактов в этом рабочем пространстве. Каждый контакт с момента появления входит во встроенную аудиторию по умолчанию, и именно builtin обозначает эту запись; остальные аудитории вы создаёте, наполняете и удаляете сами. Аудитория по умолчанию идёт первой, затем остальные — от новых к старым. Эта версия управляет списками и ничего им не отправляет, поэтому искать эндпоинт для массовой рассылки бессмысленно.

Пример

Требуется audiences:read. limit доходит до 100, по умолчанию 25.

curl
curl "$OE/audiences" -H "$AUTH"
Ответ
{  "object": "list",  "data": [    {      "object": "audience",      "id": "aud_9f2c4b7e1a0d63d84c5f2e7b",      "name": "All contacts",      "description": null,      "builtin": "default",      "contactCount": 412,      "createdAt": "2026-08-01T10:00:00.000Z",      "updatedAt": "2026-08-01T10:00:00.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

Ветвитесь по builtin, а не по имени. Аудиторию по умолчанию может переименовать кто угодно, и её имя — единственное, что в ней меняется.

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

contactCount считается в момент чтения, поэтому два чтения по обе стороны от создания расходятся на единицу. Имена не уникальны, поэтому храните id, а не имена.