दस्तावेज़ पर जाएँ
API

audience बनाएँ

एक नई, खाली audience बनाता है और उसे उसकी id के साथ लौटाता है। `name` को ट्रिम किया जाता है और उसके बाद वह 1 से 120 अक्षरों का होना चाहिए। `description` वैकल्पिक मुक्त पाठ है, उनके लिए जो बाद में सूची पढ़ें। नामों में दोहराव की जाँच नहीं होती, क्योंकि audience को उसकी id से संबोधित किया जाता है।

POSTapi.openemail.uk/audiences

असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।

POST /audiences

एक नई, खाली audience बनाता है और उसे उसकी id के साथ लौटाता है। name को ट्रिम किया जाता है और उसके बाद वह 1 से 120 अक्षरों का होना चाहिए। description वैकल्पिक मुक्त पाठ है, उनके लिए जो बाद में सूची पढ़ें। नामों में दोहराव की जाँच नहीं होती, क्योंकि audience को उसकी 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 audiences रख सकता है। इसके बाद वाली name पर 422 audience_limit_reached के साथ अस्वीकार होती है।

इसे add रूट से भरें, एक बार में एक contact, और contacts का पुस्तिका में पहले से होना ज़रूरी है।