Skip to main content
POST
Initiate Outbound Call

Prerequisites

Before making outbound calls:
  1. Register a phone number in Studio → Phone Numbers
  2. Assign an outbound agent to that phone number
  3. Configure SIP trunk with your carrier (Twilio, Telnyx, etc.)
  4. Ensure sufficient credits in your organization account
The agent assigned to from_number must use Pipeline or Realtime architecture. Text-only agents cannot make voice calls and will return a 400 error.

How It Works

Phone Number Format

Both numbers must be in E.164 format:

Authorizations

Authorization
string
header
required

Your TalkifAI API key. Get it from Studio → Settings → API Keys.

Query Parameters

to_number
string
required

Destination phone number in E.164 format

from_number
string
required

Your registered TalkifAI phone number in E.164 format

Response

Call initiated

success
boolean
Example:

true

message
string
Example:

"Call initiated successfully"

room_name
string
Example:

"outbound_agent_abc123_12025550123_1705320000"

agent
object
from_number
string
Example:

"+12025550100"

to_number
string
Example:

"+12025550123"