API ReferenceConversations

Outbound Call

Initiates a call to a given phone number using Phonic's Twilio account.

Authentication

AuthorizationBearer
Bearer authentication header of the form `Bearer <PHONIC_API_KEY>`. Manage your API keys [here](https://phonic.co/api-keys).

Request

This endpoint expects an object.
to_phone_numberstringRequired
The phone number to call in E.164 format.
configobjectOptional

When an agent is provided, these config options override the agent settings.

dry_runbooleanOptionalDefaults to false

If true, validates the outbound call setup without placing a call. Returns HTTP 200 with conversation_id set to null.

Response

Success response
OutboundDryRunResponseobject
OR
OutboundCallInitiatedResponseobject

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error