v52

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-01353775.9 KB
Conversation

post/v1/conversation/voice/outbound

Request body

phoneNumberstring required

The phone number to call in E.164 format. If a customer ID is not provided, the customer will be looked up by phone number. If no customer is found, a new customer will be created.

brandIdstring

The ID of the brand to make the call from

customerIdstring

The ID of the customer to call. If not provided, the customer will be looked up by phone number. If no customer is found, a new customer will be created.

agentIdstring

The ID of the agent to use for the call. Cannot be combined with workflowId.

workflowIdstring

The ID of the workflow to use for the call. Cannot be combined with agentId.

channelConfigIdstring

The ID of the channel config to use for the call. If not provided, the first active voice channel config will be used.

inputDataobject

Input data to pass to workflows. Should include values for input fields defined by both the chosen opening workflow and - if configured - the voicemail detected workflow.

Example request

{
  "phoneNumber": "+61400000000"
}

Response

conversationIdstring required

The ID of the conversation that was created