contact बनाएँ
वर्कस्पेस की पता-पुस्तिका में एक पता सहेजता है। पता ही पहचान है, इसलिए चुनने के लिए कोई id नहीं है और प्रतिक्रिया में भी कोई नहीं होती। संग्रह से पहले उसे ट्रिम और lowercase किया जाता है, और contact `source` को `manual` पर सेट करके सहेजा जाता है। नया contact लिखे जाते ही अंतर्निर्मित डिफ़ॉल्ट audience में शामिल हो जाता है, साथ ही `audienceIds` में नामित किसी भी audience में।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
POST /contacts
वर्कस्पेस की पता-पुस्तिका में एक पता सहेजता है। पता ही पहचान है, इसलिए चुनने के लिए कोई id नहीं है और प्रतिक्रिया में भी कोई नहीं होती। संग्रह से पहले उसे ट्रिम और lowercase किया जाता है, और contact source को manual पर सेट करके सहेजा जाता है। नया contact लिखे जाते ही अंतर्निर्मित डिफ़ॉल्ट audience में शामिल हो जाता है, साथ ही audienceIds में नामित किसी भी audience में।
उदाहरण
contacts:write चाहिए। audienceIds भेजने के लिए audiences:write भी चाहिए।
curl -X POST "$OE/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{ "email": "[email protected]", "name": "Grace Hopper", "notes": "Met at the compiler workshop"}'{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": "Met at the compiler workshop", "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" } ]}पुस्तिका में पहले से मौजूद पते पर मर्ज नहीं, बल्कि 409 contact_exists मिलता है, ताकि कोई पुनः प्रयास चुपचाप उस नाम पर न लिख दे जिसे किसी ने ऐप में संपादित किया था। इसके बजाय पंक्ति पढ़ें और उस पर PATCH करें।
lastSeenAt तब तक null रहता है जब तक ऐप के composer से उस पते पर मेल न जाए। source और lastSeenAt सर्वर के हैं और बॉडी में स्वीकार नहीं किए जाते।
audienceIds में दी गई ऐसी audience id जो इस वर्कस्पेस में मौजूद नहीं है, 404 देती है और कुछ भी नहीं लिखा जाता।