---
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`

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

## 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

- `422` — Validation Error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/8f5f4e537994/schema)