Skip to main content
POST
Initiate a single ad-hoc test call from a chosen phone number
Required scope: calls.test Idempotency: an Idempotency-Key header is required when calling with an API key. See Idempotency.

Authorizations

Authorization
string
header
required

Your API key, e.g. pk_live_xxxxxxxxxxxxxxxxxxxxxxxx.

Headers

Idempotency-Key
string
required

Unique value (e.g. a UUID) per action, up to 200 printable ASCII characters. Reuse it only to retry the same request; the first response is replayed for 24 hours.

Maximum string length: 200
Example:

"f1d2c3b4-0000-4000-8000-000000000000"

Body

application/json
agentId
string
required
toNumber
string
required
Pattern: ^\+\d{8,15}$
fromPhoneNumberId
string
required
variables
object

Response

OK

callId
string
required
externalCallId
string