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

audiences की सूची

audience इस वर्कस्पेस के contacts की एक नामित सूची है। हर contact अस्तित्व में आते ही अंतर्निर्मित डिफ़ॉल्ट audience में होता है, और `builtin` ही उस पंक्ति को नाम देता है; बाकी बनाना, भरना और हटाना आपका काम है। डिफ़ॉल्ट audience पहले आती है, फिर बाकी नई से पुरानी के क्रम में। यह संस्करण सूचियाँ संभालता है और उन्हें कुछ भेजता नहीं, इसलिए कोई broadcast एंडपॉइंट ढूँढ़ने की ज़रूरत नहीं।

GETapi.openemail.uk/audiences

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

GET /audiences

audience इस वर्कस्पेस के contacts की एक नामित सूची है। हर contact अस्तित्व में आते ही अंतर्निर्मित डिफ़ॉल्ट audience में होता है, और builtin ही उस पंक्ति को नाम देता है; बाकी बनाना, भरना और हटाना आपका काम है। डिफ़ॉल्ट audience पहले आती है, फिर बाकी नई से पुरानी के क्रम में। यह संस्करण सूचियाँ संभालता है और उन्हें कुछ भेजता नहीं, इसलिए कोई broadcast एंडपॉइंट ढूँढ़ने की ज़रूरत नहीं।

उदाहरण

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 पर शाखा बनाएँ। डिफ़ॉल्ट audience का नाम कोई भी बदल सकता है, और उसके बारे में बदलने वाली एकमात्र चीज़ उसका नाम ही है।

डिफ़ॉल्ट audience पहली बार पढ़ने पर ही तय हो जाती है, इसलिए जिस वर्कस्पेस ने कभी कोई audience नहीं बनाई, वहाँ भी ठीक एक पंक्ति सूचीबद्ध होती है।

contactCount पढ़ने के क्षण पर गिना जाता है, इसलिए किसी create के दोनों ओर की दो रीड में एक का अंतर आएगा। नाम अद्वितीय नहीं होते, इसलिए नामों के बजाय ids सहेजें।