---
title: "Create a new ConversationMessage"
method: POST
path: "/conversation_messages.json"
tags: ["Conversation Messages"]
---

# Create a new ConversationMessage

`POST /conversation_messages.json`

Outlines the parameters and data fields used when creating a new ConversationMessage

## Query parameters

- `fields` string

## Headers

- `X-API-VERSION` string

## Request body

- object
  - `data` object, required
    - `attachment` object
      - `document_id` integer — The document id of the attached document.
      - `document_version_id` integer — The document version id of the attached document.
    - `body` string, required — The body value.
    - `conversation` object
      - `id` integer — The unique identifier for a single Conversation associated with this ConversationMessage.
    - `matter` object
      - `id` integer — The unique identifier for a single Matter associated with the ConversationMessage. The keyword `null` is not valid for this field.
    - `receivers` object[], required
      - `id` integer, required — The unique identifier for a single receiver for this ConversationMessage.
      - `type` 'Contact' | 'User', required — The type for a single receiver for this ConversationMessage, could be `Contact` or `User`.
    - `subject` string, required — The subject value.

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

[API](https://skmtc.net/clio/apis/clio-api-documentation.md) · [All operations](https://skmtc.net/clio/apis/clio-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clio/clio-api-documentation/revisions/73791ddd1207/schema)