پرش به مستندات
API

ساختن یک گروه مخاطبان

یک گروه مخاطبانِ تازه و خالی می‌سازد و آن را با شناسه‌اش برمی‌گرداند. `name` هرس می‌شود و پس از آن باید بین ۱ تا ۱۲۰ نویسه باشد. `description` متن آزاد و اختیاری است برای کسی که بعدها فهرست را می‌خواند. نام‌ها از نظر تکراری‌بودن بررسی نمی‌شوند، چون یک گروه مخاطبان با شناسه‌اش نشانی‌دهی می‌شود.

POSTapi.openemail.uk/audiences

فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا می‌کند.

POST /audiences

یک گروه مخاطبانِ تازه و خالی می‌سازد و آن را با شناسه‌اش برمی‌گرداند. name هرس می‌شود و پس از آن باید بین ۱ تا ۱۲۰ نویسه باشد. description متن آزاد و اختیاری است برای کسی که بعدها فهرست را می‌خواند. نام‌ها از نظر تکراری‌بودن بررسی نمی‌شوند، چون یک گروه مخاطبان با شناسه‌اش نشانی‌دهی می‌شود.

نمونه

به 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 هرگز از بدنه پذیرفته نمی‌شود. دقیقاً یک ردیف در هر فضای کاری آن را دارد و آن ردیف از آنِ سرور است.

هر فضای کاری دست‌بالا ۱۰۰ گروه مخاطبان نگه می‌دارد. گروه بعدی با 422 audience_limit_reached روی name رد می‌شود.

آن را با مسیر افزودن پر کنید، هر بار یک مخاطب، و مخاطب‌ها باید از پیش در دفترچه باشند.