---
title: "POST /v1/conversation/voice/outbound"
method: POST
path: "/v1/conversation/voice/outbound"
tags: ["Conversation"]
---

# POST /v1/conversation/voice/outbound

`POST /v1/conversation/voice/outbound`

## Request body

- RequestOutboundCallRequestDTO
  - `phoneNumber` string, 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.
  - `brandId` string — The ID of the brand to make the call from
  - `customerId` string — 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.
  - `agentId` string — The ID of the agent to use for the call. Cannot be combined with workflowId.
  - `workflowId` string — The ID of the workflow to use for the call. Cannot be combined with agentId.
  - `channelConfigId` string — The ID of the channel config to use for the call. If not provided, the first active voice channel config will be used.
  - `inputData` object — 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.

## Response `200`

- RequestOutboundCallResponseDTO
  - `conversationId` string, required — The ID of the conversation that was created

## Changes

- **2026-05-13** `0a5817fe60b9` — 1 breaking, 1 info
  - removed the success response with the status `201`
  - added the success response with the status `200`
- **2026-04-09** `415fe1c23342` — 1 info
  - added the new optional request property `agentId`
- **2026-03-13** `9236be8d05b1` — 1 info
  - added the new optional request property `channelConfigId`
- **2026-02-11** `b4f394f05daf` — 1 info
  - the endpoint scheme security `lorikeetClientId AND lorikeetSignatureAuthV1` was removed from the API

[Change history](https://skmtc.dev/optechai/apis/lorikeet-api/changes/v1/conversation/voice/outbound/post.md)

---

[API](https://skmtc.dev/optechai/apis/lorikeet-api.md) · [All operations](https://skmtc.dev/optechai/apis/lorikeet-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optechai/lorikeet-api/revisions/789c7fa93584/schema)