HubSpot पाइपलाइन में डील जोड़ना /hubspot/v1/connections/{connection_id}/projects/{project_id}/tasks पर एक POST है, जो MakeHybrid HubSpot API में आता है: आपके संगठन के जोड़े हुए HubSpot अकाउंट, और वे पाइपलाइन जिन तक वे पहुँचते हैं। हर रिक्वेस्ट आपकी अपनी key को X-API-KEY हेडर में लेकर चलती है — वही key जो LinkedIn API की है — और सिर्फ़ उन्हीं कनेक्शनों तक पहुँचती है।
कॉल उस प्राइवेट ऐप टोकन से जाती हैं जो किसी सदस्य ने चिपकाया है, इसलिए HubSpot सब कुछ उसी ऐप के नाम से दर्ज करता है — और प्रोजेक्ट रूम अपनी डील को इसी कनेक्शन से तालमेल में रखता है।
रिक्वेस्ट
curl -X POST "https://makehybrid.com/hubspot/v1/connections/$CONNECTION_ID/projects/$PROJECT_ID/tasks" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
पाथ में क्या जाता है
- connection_id — इसी परिवार की किसी पिछली कॉल से लौटी हुई id।
- project_id — इसी परिवार की किसी पिछली कॉल से लौटी हुई id।
न चलने पर क्या लौटता है
- 401 — key नहीं है, ग़लत है या रद्द कर दी गई है।
- 402 — प्लान का भुगतान नहीं हुआ। ट्रायल ख़त्म होने पर MakeHybrid API योजना यही लौटाती है।
- 404 — या तो वह चीज़ है ही नहीं, या वह आपके संगठन की नहीं है। दोनों का जवाब जान-बूझकर एक ही है, ताकि id टटोली न जा सकें।
- 429 — बहुत ज़्यादा रिक्वेस्ट, या प्लेटफ़ॉर्म हमसे धीमे चलने को कह रहा है। दोबारा कोशिश करने से पहले थोड़ा इंतज़ार कीजिए।
- 502 या 503 — प्लेटफ़ॉर्म ने अभी जवाब नहीं दिया। थोड़ी देर में फिर कोशिश कीजिए।
हर एरर एक ही शक्ल का JSON है: {"type":"errors/<code>","status":<n>,"detail":"..."} — इसलिए एक ही हैंडलर सब संभाल लेता है, और detail इसी तरह लिखा गया है कि किसी इंसान को दिखाया जा सके।
इसके बजाय असिस्टेंट से कहिए
यह ऑपरेशन एक MCP टूल भी है। https://makehybrid.com/hubspot/mcp/<your API key> को Claude, ChatGPT या किसी भी MCP बोलने वाले असिस्टेंट में चिपकाइए और आम भाषा में जो चाहिए वह माँगिए — असिस्टेंट ख़ुद कॉल चुनेगा, id भरेगा और जवाब पढ़कर सुनाएगा। https://makehybrid.com/mcp/<your API key> वाले ऑल-इन-वन एजेंट के पास भी यह है, LinkedIn API और बाकी हर चैनल के साथ।
प्रोजेक्ट रूम में
प्रोजेक्ट रूम में अपने किसी AI एजेंट के लिए “इस्तेमाल कर सकता है” के नीचे इस API के एजेंट पर टिक कीजिए, और जब भी बातचीत को ज़रूरत हो, वह “HubSpot पाइपलाइन में डील जोड़ना” को टूल की तरह कॉल करता है। रूम में हर कोई देखता है कि उसने क्या माँगा और क्या लौटा। आम भाषा में कहिए; यहाँ एजेंट का नाम @scout है:
- @scout हमारी HubSpot पाइपलाइन में इस हफ़्ते क्या आगे बढ़ा, और क्या ठंडा पड़ गया है?
अक्सर पूछे जाने वाले सवाल
क्या कोई AI एजेंट मेरे लिए “HubSpot पाइपलाइन में डील जोड़ना” कॉल कर सकता है?
हाँ। MCP बोलने वाला कोई भी असिस्टेंट ऊपर के पते के ज़रिए कर सकता है, और प्रोजेक्ट रूम में इस API के एजेंट पर टिक वाला आपका अपना AI एजेंट भी। रूम के बिल्ट-इन एजेंट नहीं कर सकते: वे सलाह देते हैं, और उनके पास आपकी key नहीं होती।
क्या यह रूम के बाहर, मेरे अपने कोड से चलता है?
हाँ। ऊपर की रिक्वेस्ट वही ऑपरेशन है जिसे AI एजेंट के टूल कॉल करते हैं, उसी जवाब और उन्हीं एरर के साथ, और आप जिस रास्ते से भी आएँ, आपकी key उन्हीं चैनलों तक पहुँचती है।
क्या यह मेरे अपने ब्रांड वाले रूम में चलता है?
हाँ। व्हाइट-लेबल पते पर API, उसकी संदर्भिका और उसका AI एजेंट आपके प्रोडक्ट के नाम से चलते हैं, और उन्हीं नियमों के तहत उन्हीं चैनलों तक पहुँचते हैं।
क्या AI एजेंट के यह करने से पहले कोई व्यक्ति मंज़ूरी दे सकता है?
इसे AI एजेंट के निर्देशों में लिख दीजिए: वह बताए कि क्या भेजने वाला है, और रूम में किसी व्यक्ति के “जाइए” कहने तक रुके। रूम हर जवाब अपने सभी लोगों को दिखाता है, इसलिए शब्द बाहर के किसी तक पहुँचने से पहले ही दिख जाते हैं।
किस प्लान में है
MakeHybrid API प्लान में शामिल, LinkedIn API वाली उसी key के साथ: $9 प्रति सीट प्रति माह, दस सीट से $7 और हज़ार से $5। आपको उतनी सीट चाहिए जितनी इनमें से जिसकी संख्या सबसे ज़्यादा हो — LinkedIn अकाउंट, WhatsApp नंबर, X अकाउंट या इनबॉक्स अकाउंट — और 30 दिन का ट्रायल एक सीट को कवर करता है।