Voice API for Developers
Trigger outbound calls, build IVR flows, and retrieve call recordings- REST endpoints and webhooks for integrating voice calling directly into your own app or CRM.
Same account, same auth pattern as our SMS, WhatsApp & RCS APIs
Trusted by 10,000+ businesses across India
API Key Authentication
Every request is authenticated with an API key issued when your account is provisioned, passed as a bearer token in the request header.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonVoice API Endpoints
All endpoints are available under the same base URL as our other APIs- illustrative request format below, with exact field names confirmed during onboarding.
| Endpoint | Purpose |
|---|---|
| POST /v1/voice/calls | Initiate an outbound call, optionally with a pre-recorded audio URL or IVR flow ID |
| GET /v1/voice/calls/{id} | Check the status and outcome of a call by ID |
| POST /v1/voice/webhooks | Register a webhook URL for call-status and call-event notifications |
| GET /v1/voice/recordings/{id} | Retrieve a call recording by ID |
POST /v1/voice/calls
- Purpose
- Initiate an outbound call, optionally with a pre-recorded audio URL or IVR flow ID
GET /v1/voice/calls/{id}
- Purpose
- Check the status and outcome of a call by ID
POST /v1/voice/webhooks
- Purpose
- Register a webhook URL for call-status and call-event notifications
GET /v1/voice/recordings/{id}
- Purpose
- Retrieve a call recording by ID
Trigger a Call and Handle the Result
Trigger an Outbound Call
curl -X POST https://api.getclickmedia.com/v1/voice/calls \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "+9198XXXXXXXX",
"to": "+9197YYYYYYYY",
"audioUrl": "https://cdn.example.com/order-confirmation.mp3",
"ivrFlowId": "flow_8a21bd",
"recordCall": true
}'Call-Completed Webhook Payload
{
"event": "call.completed",
"callId": "call_7f3d21",
"from": "+9198XXXXXXXX",
"to": "+9197YYYYYYYY",
"status": "answered",
"durationSeconds": 47,
"recordingUrl": "https://api.getclickmedia.com/v1/voice/recordings/rec_9c12ab",
"timestamp": "2026-08-01T11:20:00Z"
}Everything you need to
integrate voice calling
Outbound calling, programmatic IVR, recordings, and webhook events- built for CRM and app integration.
Outbound Call Triggering
Programmatically initiate calls from your own app, order system, or backend job- no manual dialing.
Programmatic IVR
Drive an IVR call flow with your own backend logic instead of (or alongside) the visual flow builder.
Call Recording Retrieval
Pull recordings by call ID into your own support or QA tooling for review and training.
Webhook Events
Receive real-time events for call status and outcome instead of polling the API.
Delivery & Status Tracking
Check answered, missed, failed, or in-progress status for any call by ID.
Common Ways Developers Use the Voice API
Order confirmation calls
Trigger a confirmation call automatically from your order-management system when a new order or cash-on-delivery request comes in.
Custom-built IVR flows
Drive call routing entirely from your own backend logic- useful when your routing rules depend on data that lives in your own systems, not a static menu tree.
Recordings in your own tooling
Pull call recordings into your existing support or QA dashboard instead of asking agents to check a separate portal.
From Credentials to Production in 3 Steps
Get API credentials
Receive your API key after onboarding- issued for your account and passed as a bearer token on every request.
Test in a sandbox
Trigger test calls and simulate webhook events before pointing your integration at live traffic. Ask your onboarding contact about sandbox access for your account.
Go live
Switch to your production credentials and start triggering real calls- your account manager can confirm rollout steps for your specific use case.
One message could
change your business.
Big or small, we power communication for all- talk to us today.
Voice API FAQs
The Voice API lets you trigger outbound calls programmatically, drive IVR call flows using your own backend logic, retrieve call recordings by ID, and receive webhook events for call status and outcome- all from your own app, CRM, or backend system.
Every request is authenticated with an API key issued during onboarding, passed as a bearer token in the Authorization header- the same authentication pattern used across Get Click Media's SMS, WhatsApp, and RCS APIs.
All Voice API endpoints are available under https://api.getclickmedia.com/v1/voice/- for example, POST /v1/voice/calls to trigger a call or GET /v1/voice/recordings/{id} to retrieve a recording.
Yes- pass an audioUrl pointing to your pre-recorded audio when calling POST /v1/voice/calls, and the platform plays it to the recipient once the call connects.
Yes- pass an ivrFlowId to drive a flow you've built, or drive routing entirely from your own backend logic by handling call events via webhook and issuing follow-up API calls. Many developers use a mix of both- the visual builder for standard flows, API-driven logic for flows that depend on their own application data.
Register a webhook URL via POST /v1/voice/webhooks to receive a call.completed event (or similar call-status events) with the call's status, duration, and recording URL- instead of polling GET /v1/voice/calls/{id} repeatedly.
Yes- GET /v1/voice/recordings/{id} retrieves a recording by ID, and the recording URL is also included directly in the call-completed webhook payload for convenience.
Ask your onboarding contact about sandbox or test-mode access for your account- it lets you trigger test calls and simulate webhook events before pointing your integration at live traffic.
Rate limits apply and vary by plan and call volume- your account manager will confirm the exact figures for your account so you can design your integration accordingly.
Voice API pricing depends on your call volume, number type, and which features you use (recording, IVR flows, webhook volume). Contact us for a custom quote based on your expected usage.
Ready to integrate voice calling into your app?
Get API access, full endpoint documentation, and integration support from our team.