# Add an internal note to a conversation

> Inserts a `note` message visible only in the operator dashboard.

Source: https://www.hey.support/docs/api/conversations/create-conversation-note

---

<ApiEndpoint method="POST" path="/conversations/{id}/messages" />

Notes are never shown to the visitor and are not sent to the AI. The role is always `note` — this endpoint cannot post a reply on the agent’s behalf.

## Path parameters

<TypeTable
  type={{
  "id": { type: "string", description: "", required: true }
}}
/>

## Request body

<TypeTable
  type={{
  "content": { type: "string", description: "", required: true }
}}
/>

## Response `200`

<TypeTable
  type={{
  "id": { type: "string", description: "", required: true },
  "role": { type: "\"user\" | \"assistant\" | \"system\"", description: "", required: true },
  "content": { type: "string", description: "", required: true },
  "created_at": { type: "string (date-time)", description: "", required: true }
}}
/>

### Errors

* `400` — Invalid request body
* `401` — Missing or invalid API key
* `404` — Not found
* `429` — Rate limit exceeded

Every error shares [one envelope](/docs/api/errors).

## Example

```bash
curl -X POST \
  https://www.hey.support/api/v1/conversations/<id>/messages \
  -H 'Authorization: Bearer hs_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"content":"<content>"}'
```