API संदर्भ
Live — v1 available now

REST API

AI voice calls trigger करें, contacts sync करें और किसी भी backend, CRM या no-code tool से call results पढ़ें।

Base URL:https://outboundcalls.ai/api/v1

Authentication

Generate an API key from Dashboard → Settings → API Keys. हर request में इसे Bearer token के रूप में भेजें।

Authorization: Bearer oc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keys at rest hash की जाती हैं और केवल only onceबनाते समय दिखाई जाती हैं। उसी Settings page से कभी भी rotate या revoke करें।

आप क्या जोड़ सकते हैं

API simple REST + Bearer token है, इसलिए यह HTTPS समझने वाली किसी भी चीज़ के साथ काम करता है — SDK की आवश्यकता नहीं।

Zapier

Webhooks + HTTP

जब आपके CRM, spreadsheet या form में नया lead जुड़ता है, तो calls trigger करें।

Make (Integromat)

HTTP मॉड्यूल

visual workflows बनाएँ: Form → OutboundCalls → Slack/Email/CRM अपडेट।

n8n

HTTP Request नोड

Self-hosted ऑटोमेशन। अपने database, scheduler या messaging stack को connect करें।

HubSpot / Salesforce / Pipedrive

CRM

नए contacts को अपने-आप campaign में भेजें; call summaries को activity records के रूप में वापस लाएँ।

कस्टम backend (Node, Python, PHP, Go, Ruby)

कोई भी भाषा

मानक REST + Bearer token। जो भी HTTPS call कर सकता है, उसके साथ काम करता है।

No-code प्लेटफ़ॉर्म (Bubble, Retool, Airtable Automations)

No-code

endpoint को workflow action में जोड़ें — SDK की ज़रूरत नहीं।

वास्तविक workflows जो आप बना सकते हैं

कोई नया lead आपका Typeform भरता है → 30 सेकंड के भीतर उसे call करें
Booking confirmation in Calendly → AI agent calls 24h before to confirm
Failed Stripe payment → reminder call instead of just an email
आपके CRM से रोज़ाना CSV upload → AI agent कामकाजी घंटों में हर contact को call करता है
WhatsApp inbound message → callback from voice agent if requested
लंबे समय तक चलने वाले campaign की progress हर 15 मिनट में आपके data warehouse में sync होती है

Endpoints

खाता

GET/me

एजेंट्स

GET/agents
GET/agents/:id

कॉन्टैक्ट्स

GET/contacts
POST/contacts

कॉल्स

POST/calls
GET/calls
GET/calls/:id

कैम्पेन्स

GET/campaigns
GET/campaigns/:id

अधिक endpoints (agents create/update/delete करना, CSV import, campaign control) roadmap में हैं। कोई endpoint तुरंत चाहिए?Tell us.

Code examples

cURL
# Trigger an outbound call from your agent
curl -X POST https://outboundcalls.ai/api/v1/calls \
  -H "Authorization: Bearer oc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "clxAGENT123",
    "toNumber": "+14155551212",
    "contactId": "clxCONTACT456"
  }'

# Response
{
  "id": "clxCALL789",
  "phoneFrom": "+12025550100",
  "phoneTo": "+14155551212",
  "status": "RINGING",
  "elevenlabsConvId": "conv_abc...",
  "createdAt": "2026-04-29T10:32:11.000Z"
}
JavaScript / Node.js
// Trigger a call from any Node.js / browser app
const r = await fetch('https://outboundcalls.ai/api/v1/calls', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.OC_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    agentId: 'clxAGENT123',
    toNumber: '+14155551212',
  }),
});
const call = await r.json();
console.log(call.id, call.status); // RINGING

// Later — fetch transcript & summary
const detail = await fetch(`https://outboundcalls.ai/api/v1/calls/${call.id}`, {
  headers: { Authorization: `Bearer ${process.env.OC_API_KEY}` },
}).then(r => r.json());
console.log(detail.summary, detail.transcript);

Post-call webhook

हर agent पर webhook URL configure करें। हर call के बाद, OutboundCalls आपके endpoint पर signed JSON payload POST करता है, जिसमें ये शामिल होता है:

  • Full transcript
  • Recording URL
  • AI-generated summary
  • Sentiment score
  • Goal achieved (true/false)
  • Extracted data fields
  • Duration + credits charged
  • Voicemail flag

सभी payloads HMAC-SHA256 से signed होते हैं। header को अपने agent के webhook secret से verify करें।

हफ्तों नहीं, मिनटों में launch करें

Account बनाएँ, API key generate करें और 5 मिनट से कम समय में अपनी पहली call trigger करें।