Przejdź do dokumentacji
API

Tworzenie grupy odbiorców

Tworzy nową, pustą grupę odbiorców i zwraca ją wraz z jej id. `name` jest przycinane i musi mieć potem od 1 do 120 znaków. `description` to opcjonalny dowolny tekst dla tych, którzy będą czytać listę później. Nazwy nie są sprawdzane pod kątem duplikatów, ponieważ grupę odbiorców adresuje się jej id.

POSTapi.openemail.uk/audiences

Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.

POST /audiences

Tworzy nową, pustą grupę odbiorców i zwraca ją wraz z jej id. name jest przycinane i musi mieć potem od 1 do 120 znaków. description to opcjonalny dowolny tekst dla tych, którzy będą czytać listę później. Nazwy nie są sprawdzane pod kątem duplikatów, ponieważ grupę odbiorców adresuje się jej id.

Przykład

Wymaga 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"}'
Odpowiedź
{  "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 nigdy nie jest przyjmowane z treści żądania. Dokładnie jeden wiersz na przestrzeń roboczą je niesie, a ten wiersz należy do serwera.

Przestrzeń robocza mieści najwyżej 100 grup odbiorców. Kolejna jest odrzucana z 422 audience_limit_reached na polu name.

Wypełnij ją endpointem dodawania, po jednym kontakcie naraz — kontakty muszą już być w książce adresowej.