contact की audiences तय करें
एक ही कॉल में ठीक-ठीक बताता है कि एक संपर्क किन ऑडियंस में है। संपर्क `audienceIds` की हर उस ऑडियंस में जुड़ता है जिसमें वह अभी नहीं है और बाक़ी सबसे निकल जाता है। डिफ़ॉल्ट ऑडियंस हमेशा बनी रहती है, इसलिए खाली सूची संपर्क को सिर्फ़ डिफ़ॉल्ट ऑडियंस में छोड़ती है।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
PUT /contacts/{email}/audiences
एक ही कॉल में ठीक-ठीक बताता है कि एक संपर्क किन ऑडियंस में है। संपर्क audienceIds की हर उस ऑडियंस में जुड़ता है जिसमें वह अभी नहीं है और बाक़ी सबसे निकल जाता है। डिफ़ॉल्ट ऑडियंस हमेशा बनी रहती है, इसलिए खाली सूची संपर्क को सिर्फ़ डिफ़ॉल्ट ऑडियंस में छोड़ती है।
उदाहरण
audiences:write चाहिए, क्योंकि यह संपर्क नहीं बल्कि सदस्यताएँ लिखता है। @ को URL-एन्कोड करें। audienceIds में 100 तक ID आ सकते हैं।
curl -X PUT "$OE/contacts/grace%40example.com/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{ "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"]}'{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": null, "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-18T09:00:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }, { "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "builtin": null } ]}संपर्क पहले से मौजूद होना चाहिए। जो पता पुस्तिका में नहीं है वह 404 contact_not_found देता है। उसे POST /contacts से बनाएँ, जो audienceIds भी लेता है।
जो ID इस वर्कस्पेस की किसी ऑडियंस की ओर इशारा नहीं करती वह 404 audience_not_found देती है और कुछ नहीं बदलता, इसलिए कोई टाइपो चुपचाप किसी को सूची से नहीं निकाल सकता। वही कॉल दोबारा भेजने से कुछ नहीं बदलता।
जवाब वही संपर्क है जो GET /contacts/{email} लौटाता है, बदलाव के बाद की उसकी हर ऑडियंस के साथ।