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

# POST /v1/conversation/whatsapp/outbound

`POST /v1/conversation/whatsapp/outbound`

## Request body

- RequestOutboundWhatsappRequestDTO
  - `phoneNumber` string, required — The phone number to send the WhatsApp message to 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.
  - `initialMessage` string — The initial message to send to the customer. Required if contentSid is not provided.
  - `brandId` string — The ID of the brand to send the WhatsApp message from
  - `customerId` string — The ID of the customer to message. If not provided, the customer will be looked up by phone number. If no customer is found, a new customer will be created.
  - `contentSid` string — The Twilio Content Template SID to use for outbound messages. Required for initiating conversations outside the 24-hour session window.
  - `contentVariables` object — Template variables as key-value pairs for the content template.
  - `workflowId` string — The ID of the workflow to use for generating the opening message. Required if neither initialMessage nor contentSid is provided.
  - `channelConfigId` string — The ID of the channel config to use for the WhatsApp message. If not provided, the first active WhatsApp channel config will be used.
  - `inputData` object — Input data to pass to the workflow when workflowId is provided.

## Response `200`

- RequestOutboundWhatsappResponseDTO
  - `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** `2e7c56c5e808` — 1 info
  - endpoint added
- **2026-02-18** `7ebe7ece6f53` — 1 breaking
  - api path removed without deprecation
- **2026-02-12** `ea2fb7d0e99f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/optechai/apis/lorikeet-api/changes/v1/conversation/whatsapp/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)