Belgelere geç
API

Kitle oluşturma

Yeni ve boş bir kitle oluşturur ve id'siyle birlikte döndürür. `name` kırpılır ve ardından 1 ile 120 karakter arasında olmalıdır. `description`, listeyi sonradan okuyacak kişi için isteğe bağlı serbest metindir. Adlar yinelenme açısından denetlenmez, çünkü bir kitleye id'siyle erişilir.

POSTapi.openemail.uk/audiences

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

POST /audiences

Yeni ve boş bir kitle oluşturur ve id'siyle birlikte döndürür. name kırpılır ve ardından 1 ile 120 karakter arasında olmalıdır. description, listeyi sonradan okuyacak kişi için isteğe bağlı serbest metindir. Adlar yinelenme açısından denetlenmez, çünkü bir kitleye id'siyle erişilir.

Örnek

audiences:write gerektirir.

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"}'
Yanıt
{  "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 gövdeden asla kabul edilmez. Çalışma alanı başına tam olarak bir satır onu taşır ve o satır sunucuya aittir.

Bir çalışma alanı en çok 100 kitle tutar. Bir sonraki, name üzerinde 422 audience_limit_reached ile reddedilir.

Kitleyi ekleme uç noktasıyla, her seferinde bir kişi olacak şekilde doldurun; kişilerin defterde zaten bulunuyor olması gerekir.