API 레퍼런스
Live — v1 available now

REST API

모든 백엔드, CRM 또는 노코드 도구에서 AI 음성 통화를 실행하고, 연락처를 동기화하며, 통화 결과를 조회합니다.

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

Authentication

Generate an API key from Dashboard → Settings → API Keys. 모든 요청에서 Bearer 토큰으로 전달합니다.

Authorization: Bearer oc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

키는 저장 시 해시 처리되며, 생성 시 한 번만only once표시됩니다. 동일한 설정 페이지에서 언제든지 교체하거나 폐기할 수 있습니다.

연동 가능한 대상

API는 일반 REST + Bearer 토큰 방식이므로 HTTPS를 지원하는 모든 도구와 연동됩니다. SDK가 필요하지 않습니다.

Zapier

Webhook + HTTP

CRM, 스프레드시트 또는 양식에 신규 lead가 추가되면 통화를 실행합니다.

Make (Integromat)

HTTP 모듈

시각적 워크플로를 구축합니다: 양식 → OutboundCalls → Slack/이메일/CRM 업데이트.

n8n

HTTP 요청 노드

직접 호스팅하는 자동화입니다. 데이터베이스, 스케줄러 또는 메시징 스택과 연결합니다.

HubSpot / Salesforce / Pipedrive

CRM

신규 연락처를 캠페인에 자동으로 추가하고, 통화 요약을 활동 기록으로 다시 가져옵니다.

커스텀 백엔드(Node, Python, PHP, Go, Ruby)

모든 언어

표준 REST + Bearer 토큰입니다. HTTPS 호출을 보낼 수 있는 모든 환경에서 작동합니다.

노코드 플랫폼(Bubble, Retool, Airtable Automations)

노코드

엔드포인트를 워크플로 작업에 연결하기만 하면 됩니다. SDK가 필요하지 않습니다.

구축 가능한 실제 워크플로

신규 lead가 Typeform을 작성하면 → 30초 이내에 통화합니다
Booking confirmation in Calendly → AI agent calls 24h before to confirm
Failed Stripe payment → reminder call instead of just an email
CRM에서 매일 CSV 업로드 → AI 에이전트가 업무 시간 중 각 연락처로 통화합니다
WhatsApp inbound message → callback from voice agent if requested
장기 실행 캠페인의 진행률을 15분마다 데이터 웨어하우스에 동기화합니다

Endpoints

계정

GET/me

에이전트

GET/agents
GET/agents/:id

연락처

GET/contacts
POST/contacts

통화

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

캠페인

GET/campaigns
GET/campaigns/:id

더 많은 엔드포인트(에이전트 생성/수정/삭제, CSV 가져오기, 캠페인 제어)는 로드맵에 포함되어 있습니다. 긴급히 필요하십니까?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

각 에이전트에 webhook URL을 설정합니다. 모든 통화 후 OutboundCalls가 다음 정보를 포함한 서명된 JSON 페이로드를 귀사의 엔드포인트로 POST합니다.

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

모든 페이로드는 HMAC-SHA256으로 서명됩니다. 에이전트의 webhook 시크릿으로 헤더를 검증합니다.

몇 주가 아니라 몇 분 만에 출시합니다

계정을 만들고 API 키를 생성한 뒤, 5분 이내에 첫 통화를 실행할 수 있습니다.