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

हस्ताक्षर बनाएँ

किसी पते या कैच-ऑल में नाम वाला हस्ताक्षर जोड़ें।

POST/signatures

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

POST /signatures

किसी पते या कैच-ऑल में नाम वाला हस्ताक्षर जोड़ें।

उदाहरण

settings:write चाहिए। address, name और html ज़रूरी हैं।

curl
curl -X POST "$OE/signatures" -H "$AUTH" -H "Content-Type: application/json" \  -d '{    "address": "[email protected]",    "name": "Short",    "html": "<p>Ada<br>Acme Ltd</p>",    "isReplyDefault": true  }'
प्रतिक्रिया
{  "object": "signature",  "id": "sig_8f2c1a9b7d3e4f60a1b2c3d4",  "address": "[email protected]",  "name": "Short",  "html": "<p>Ada<br />Acme Ltd</p>",  "isDefault": false,  "isReplyDefault": true,  "createdAt": "2026-10-12T09:14:03.117Z",  "updatedAt": "2026-10-12T09:14:03.117Z"}

HTML उसी तरह साफ़ किया जाता है जैसे बाहर जाने वाला मेल, इसलिए जो लौटता है वह आपके भेजे से अलग हो सकता है, और उसमें कुछ टेक्स्ट या कोई इमेज बची रहनी चाहिए। यह साफ़ किए जाने से पहले और बाद में ज़्यादा से ज़्यादा 150,000 वर्ण लेता है, वरना कॉल 422 signature_too_long देती है।

किसी पते का पहला हस्ताक्षर नए मेल और जवाबों के लिए उसका डिफ़ॉल्ट बन जाता है, जब तक isDefault या isReplyDefault false न हो। बाद का हस्ताक्षर सिर्फ़ कहने पर डिफ़ॉल्ट बनता है, और तब वह जगह उस हस्ताक्षर से ले लेता है जिसके पास वह थी।

name 1 से 80 वर्णों का होता है और अपने पते पर अनोखा होता है, छोटे-बड़े अक्षरों का फ़र्क किए बिना। जो नाम पता पहले से इस्तेमाल करता है वह 409 signature_name_taken देता है। एक पते में ज़्यादा से ज़्यादा 50 हस्ताक्षर हो सकते हैं, और उसके बाद वाला 422 signature_limit_reached देता है।

पता वर्कस्पेस का कोई पता होना चाहिए, या यहाँ के किसी सत्यापित डोमेन का कैच-ऑल जिसका कैच-ऑल चालू हो। बाकी कुछ भी, पूरा डोमेन समेत, 422 invalid_parameter देता है।

संदर्भ