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

# POST /v1/conversation/sms/outbound

`POST /v1/conversation/sms/outbound`

## Request body

- RequestOutboundSmsRequestDTO
  - `phoneNumber` string, required — The phone number to send the SMS 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. If not provided, a workflow ID must be specified and the workflow will generate the opening message.
  - `brandId` string — The ID of the brand to send the SMS 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.
  - `workflowId` string — The ID of the workflow to use for generating the opening message. Required if initialMessage is not provided.
  - `channelConfigId` string — The ID of the channel config to use for the SMS. If not provided, the first active SMS channel config will be used.
  - `inputData` object — Input data to pass to the workflow when workflowId is provided.

## Response `200`

- RequestOutboundSmsResponseDTO
  - `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-11** `b4f394f05daf` — 1 info
  - the endpoint scheme security `lorikeetClientId AND lorikeetSignatureAuthV1` was removed from the API
- **2026-01-30** `f0a49e255d1c` — 1 info
  - endpoint added

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