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

किसी audience में contact जोड़ें

यह वर्कस्पेस बुक में पहले से मौजूद किसी पते को लेता है और सदस्यता लौटाता है, साथ में वह contact भी जिसकी ओर वह इशारा करती है। हर audience और contact के लिए एक ही सदस्यता होती है, इसलिए जो व्यक्ति पहले से audience में है उसे जोड़ने पर, दूसरी सदस्यता बनाने या विफल होने के बजाय मूल `addedAt` के साथ `200` मिलता है। इससे यह कॉल दोबारा चलाना सुरक्षित रहता है।

POSTapi.openemail.uk/audiences/{id}/contacts

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

POST /audiences/{id}/contacts

यह वर्कस्पेस बुक में पहले से मौजूद किसी पते को लेता है और सदस्यता लौटाता है, साथ में वह contact भी जिसकी ओर वह इशारा करती है। हर audience और contact के लिए एक ही सदस्यता होती है, इसलिए जो व्यक्ति पहले से audience में है उसे जोड़ने पर, दूसरी सदस्यता बनाने या विफल होने के बजाय मूल addedAt के साथ 200 मिलता है। इससे यह कॉल दोबारा चलाना सुरक्षित रहता है।

उदाहरण

audiences:write चाहिए।

curl
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{  "email": "[email protected]"}'
प्रतिक्रिया
{  "object": "audience_member",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "addedAt": "2026-09-18T09:30:00.000Z",  "contact": {    "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"  }}

जो पता contact नहीं है, उसे मौके पर बनाया नहीं जाता, बल्कि 422 contact_not_found के साथ अस्वीकार किया जाता है। पहले उसे POST /contacts से सहेजें।

केवल audiences:write ही जाँचा जाता है। किसी contact को सूची में डालना उस contact पर लिखना नहीं है।

हर contact के लिए एक कॉल। इस संस्करण में थोक जोड़ने की सुविधा नहीं है, और बाद में contact हटाने पर यह सदस्यता भी उसके साथ चली जाती है।