---
title: "Create Message"
method: POST
path: "/ai/conversations/{conversation_id}/message"
tags: ["Conversations"]
---

# Create Message

`POST /ai/conversations/{conversation_id}/message`

Add a new message to the conversation. Used to insert a new messages to a conversation manually ( without using chat endpoint )

## Path parameters

- `conversation_id` string, uuid, required — The ID of the conversation

## Request body

- CreateMsgReq
  - `role` string, required
  - `content` string
  - `name` string
  - `tool_choice` union
    - string
    - object
  - `tool_calls` object[]
  - `tool_call_id` string
  - `sent_at` string, date-time
  - `metadata` object

## Response `200`

Successful Response

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