---
title: "createMessage - Create a message in a conversation"
method: POST
path: "/conversations/{conversationId}/messages"
tags: ["Conversations"]
---

# createMessage - Create a message in a conversation

`POST /conversations/{conversationId}/messages`

## Request

- Base URL: `https://miraklconnect.com/api`
- URL: `https://miraklconnect.com/api/conversations/{conversationId}/messages`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mirakl/apis/mirakl-connect-apis/docs/conversations/:conversationId/messages/post.ts> (a function with typed inputs; its response is checked against the schema)

<div class="extension-title">Description</div>

Use this API to create a new message to the customer in a conversation.

<div class="api-description-extension">
</div>

## Path parameters

- `conversationId` string, required

## Request body `multipart/form-data`

- object
  - `files` string[]: Optional file attachments
  - `message_input` MessageInput, required
    - `body` string, required: Body of the message

## Response `202`

Message creation initiated

- ConversationActionIdResponse
  - `action_id` string, required: Unique identifier of the action. Use `getConversationActionStatus` to retrieve the result of your request.

## Other responses

- `400`: Bad request
- `404`: Conversation not found

---

[API](https://skmtc.dev/mirakl/apis/mirakl-connect-apis.md) - [All operations](https://skmtc.dev/mirakl/apis/mirakl-connect-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/mirakl/apis/mirakl-connect-apis/revisions/c0527a972b89?raw)