Callflow API Reference
Base URL https://api.callflow.com/v1• JSON format • Bearer token authentication.
Voice & Calling
/api/v1/calls/dialPlace an outbound WebRTC or PSTN softphone call
/api/v1/callsList and filter call history with disposition filters
/api/v1/calls/{id}Retrieve full call detail record with latency telemetry
/api/v1/calls/{id}/recordingFetch signed dual-channel audio recording URL
/api/v1/calls/{id}/transcriptionDownload AI transcript with speaker tags & sentiment
Phone Numbers & SIP Trunks
/api/v1/numbers/availableSearch purchasable local and toll-free DID numbers
/api/v1/numbers/provisionInstantly provision virtual numbers across 85+ countries
/api/v1/numbers/{id}Release provisioned virtual number from account
Messaging (SMS & WhatsApp)
/api/v1/messages/smsSend single transactional SMS with sub-2s delivery
/api/v1/messages/sms/bulkDispatch up to 10,000 personalized SMS in batches
/api/v1/messages/whatsappSend verified WhatsApp Business template message
/api/v1/messages/whatsapp/sessionReply to inbound WhatsApp chat within 24h window
CRM Contacts & Customer 360
/api/v1/contactsSearch customer dossiers with custom attribute filters
/api/v1/contactsCreate or atomically upsert customer 360 profile
/api/v1/contacts/{id}/timelineFetch unified chronological omnichannel timeline
Webhooks & Events
/api/v1/webhooksList active webhook subscriptions and delivery logs
/api/v1/webhooksCreate new HMAC-SHA256 signed webhook listener
/api/v1/webhooks/{id}Remove webhook subscription
Sample Inbound Call Hook
// 200 OK — POST /api/v1/calls/dial
{
"call_id": "call_98af21d0",
"status": "ringing_destination",
"agent_id": "usr_aarav_sharma",
"to": "+919820112345",
"caller_id": "+918049200000",
"recording_enabled": true,
"created_at": "2026-10-29T14:55:03Z"
}