> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reply to Conversation

> Send a reply or add an internal note

Send an email reply to the subscriber or add an internal team note. Replies are queued for delivery and reopen closed conversations. Notes are only visible to your team and do not reopen conversations.

## Request

<ParamField path="conversationId" type="string" required>
  Conversation ID.
</ParamField>

<ParamField body="type" type="string">
  Message type: `outbound` sends an email reply (default), `note` adds an
  internal note.
</ParamField>

<ParamField body="subject" type="string">
  Message subject. Defaults to the conversation subject.
</ParamField>

<ParamField body="bodyText" type="string">
  Plain text body. Outbound messages require `bodyText` or `bodyHtml`.
</ParamField>

<ParamField body="bodyHtml" type="string">
  HTML body. Outbound messages require `bodyText` or `bodyHtml`.
</ParamField>

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/v1/conversations/conv_abc123/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bodyText": "Happy to help! Let me know if you have other questions."}'
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": {
      "id": "msg_new123",
      "conversationId": "conv_abc123",
      "type": "outbound",
      "subject": "Re: A quick update",
      "bodyText": "Happy to help! Let me know if you have other questions.",
      "bodyHtml": null,
      "fromEmail": "support@example.com",
      "fromName": null,
      "fromUserId": "user_abc123",
      "attachments": [],
      "isRead": true,
      "createdAt": "2026-06-11T10:00:00.000Z",
      "deliveryStatus": "pending"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": "Message body is required"
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Conversation not found"
  }
  ```

  ```json 500 theme={null}
  {
    "error": "Failed to create message"
  }
  ```
</ResponseExample>