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
500
Internal Server Error