---
title: "Create a new message record"
method: POST
path: "/chat/message/create"
tags: ["API: Streaming Messaging"]
---

# Create a new message record

`POST /chat/message/create`

Create a new message record. This endpoint should be used when a Streaming flow is selected or when a messageId/conversationId has to be known in advance.

## Request body

- CreateChatMessageRequest
  - `channelId` string, uuid, required — ID of the channel on which the conversation was or will be initiated.
  - `source` string, required — The source of the chat conversation to be used for your analytics and debugging purposes.
  - `message` string, text, required — Content of the user message.
  - `conversationId` string, uuid — ID of the conversation/thread. If present, will add the newly created message record to the conversation history. Otherwise, will create a new conversation.
  - `senderId` string — An optional user identifier to be used for your analytics and debugging purposes.

## Response `200`

Response containing details of the newly created message record.

- CreateChatMessageResponse
  - `conversationId` string, uuid — ID of the chat conversation/thread.
  - `messageId` string, uuid — ID of the message record that was created.
  - `messageContent` string, text — Content of the message that was created.
  - `channelId` string, uuid — ID of the channel on which the conversation was initiated.
  - `createdAt` string, date-time — Date time of when the message record was created. UTC Timezone.

## Other responses

- `422` — Some or all of the received payload is unprocessable.
- `500` — Internal server error

---

[API](https://skmtc.dev/sentiyen/apis/sentiyen-api-v3.md) · [All operations](https://skmtc.dev/sentiyen/apis/sentiyen-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sentiyen/sentiyen-api-v3/revisions/8ce4e621146e/schema)