---
title: "Create message"
method: POST
path: "/conversation/{conversationId}/message/create"
tags: ["Conversation Message"]
---

# Create message

`POST /conversation/{conversationId}/message/create`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/conversation/{conversationId}/message/create`
- Auth: HTTP bearer

## Path parameters

- `conversationId` string, required: The ID of the conversation

## Request body

- object: Instance crud properties
  - `name` string: The associated name
  - `description` string: The associated description
  - `meta` Meta: Meta data information
  - `type` 'user' | 'bot' | 'reasoning' | 'context' | 'instruction' | 'backstory' | 'activity' | 'checkpoint', required: The type of the message
  - `text` string, required: The text of the message
  - `entities` Entity[]: Known entities
    - `type` string, required: The entity type
    - `begin` number, required: Start offset
    - `end` number, required: End offset
    - `text` string, required: The text value of the entity
    - `replacement` object
      - `begin` number, required: Start offset
      - `end` number, required: End offset
      - `text` string, required: The text value of the replacement

## Response `200`

The message was created successfully

- object
  - `id` string, required: The ID of the created message
  - `entities` Entity[], required: Extracted entities from the message
    - `type` string, required: The entity type
    - `begin` number, required: Start offset
    - `end` number, required: End offset
    - `text` string, required: The text value of the entity
    - `replacement` object
      - `begin` number, required: Start offset
      - `end` number, required: End offset
      - `text` string, required: The text value of the replacement

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)