Skip to main content
POST
Create outbound calls

Authorizations

x-api-key
string
header
required

Create and manage API keys in your AgentCallback account under Dashboard > API Keys.

Body

application/json

Call dispatch payload.

contacts
required
Minimum array length: 1
useCase
integer

Voice agent use case or script identifier used for standalone calls.

campaign_id
string<uuid>

Active API-contact-enabled campaign identifier. Contacts are accepted only after the campaign starts.

fromPhoneNumber
string

Outbound caller ID. Omit when dispatching an existing campaign.

Response

Calls accepted for processing

success
boolean
required
Example:

true

message
string
required
Example:

"Call requests received and being processed"

totalCalls
integer
required

Number of accepted contacts.

useCase
integer
required

Resolved voice agent use case.

fromPhoneNumber
string | null