Developers
Build voice into
any workflow.
Connect calls, agents and business actions through a clear API surface.
Illustrative API example
Create an outbound call.
The example demonstrates the intended integration shape. Confirm the production API contract before implementation.
Authentication
Use a server-side bearer token. Never expose TARANGNOW_API_KEY in client code.
Agent configuration
Reference a configured agent and approved language locale.
Outbound calls
Create calls with an E.164 phone number and monitor the returned status.
Webhooks
Receive call lifecycle, transcript, action and completion events.
Error handling
Use stable error codes, retry only safe requests and log request identifiers.
const response = await fetch(
`${process.env.NEXT_PUBLIC_API_URL}/v1/calls`,
{
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${process.env.TARANGNOW_API_KEY}`,
},
body: JSON.stringify({
agentId: "agent_sales_01",
phoneNumber: "+91XXXXXXXXXX",
language: "ta-IN",
}),
}
);Call events
01
call.queued
02
call.connected
03
action.completed
04
call.ended
Connect the first workflow.
Discuss the API contract, telephony setup and action requirements with the TarangNow team.