---
title: "Assistant Sms Chat"
method: POST
path: "/ai/assistants/{assistant_id}/chat/sms"
tags: ["Assistants"]
---

# Assistant Sms Chat

`POST /ai/assistants/{assistant_id}/chat/sms`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/assistants/{assistant_id}/chat/sms`
- Auth: HTTP bearer

Send an SMS message for an assistant. This endpoint: 
1. Validates the assistant exists and has messaging profile configured 
2. If should_create_conversation is true, creates a new conversation with metadata 
3. Sends the SMS message (If `text` is set, this will be sent. Otherwise, if this is the first message in the conversation and the assistant has a `greeting` configured, this will be sent. Otherwise the assistant will generate the text to send.) 
4. Updates conversation metadata if provided 
5. Returns the conversation ID

## Path parameters

- `assistant_id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- AssistantSmsChatReq
  - `from` string, required
  - `to` string, required
  - `text` string
  - `conversation_metadata` object
  - `should_create_conversation` boolean

## Response `200`

Successful Response

- AssistantSmsChatResponse
  - `conversation_id` string

## Other responses

- `400`: Bad Request / Validation Failed (10015). Invalid, duplicate, empty, malformed, or overlong Idempotency-Key headers are rejected by Edge with HTTP 400 and error code 10015.
- `409`: A request with the same Idempotency-Key is still being processed (10036). Retry later with the same key and request.
- `413`: Payload Too Large. A request sent with an Idempotency-Key whose body exceeds the endpoint's Edge replay-protection limit (256 KB) is rejected before it reaches the service. Requests sent without the header are not subject to this limit.
- `422`: Validation Error. Reusing an Idempotency-Key with a different request body also returns 422 with error code 10027.
- `503`: Service unavailable (10016), including unavailable Edge idempotency protection for a keyed request.

## Changes

- **2026-10-15** `a72569d69430`: 1 breaking, 1 warning, 6 info
  - the response's body type changed from `object` to no type for status `422`
  - removed the optional property `detail` from the response with the `422` status
  - added the new optional `header` request parameter `Idempotency-Key`
  - added `#/components/schemas/HTTPValidationError, #/components/schemas/inference-embedding_ErrorResponse` to the response body `anyOf` list for the response status `422`
  - …4 more

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/ai/assistants/:assistant_id/chat/sms/post.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/a73101b68823?raw)