# conversation.note.added (/webhooks/events/conversation-note-added)

Fires when an internal note is added to a conversation. Notes are only visible to your team, not to the customer — treat their contents accordingly on your receiving side.

The payload carries the note as a `conversation_message` object.

For the envelope fields, see [The webhook request](/webhooks#the-webhook-request).

## Example payload

```json
{
  "id": "evt_019f419bd6e772699bd43933d0e6124c",
  "eventType": "conversation.note.added",
  "timestamp": "2026-07-08T12:02:40.009Z",
  "accountId": "1001",
  "payload": {
    "conversation_message": {
      "id": "55180",
      "body_html": "<p>Team, treat this as urgent priority.</p>",
      "body_text": "Team, treat this as urgent priority.",
      "attachments": [],
      "author": {
        "id": 8544,
        "name": "Alex Carter",
        "email": "alex@acme.com",
        "phone": null,
        "type": "agent"
      },
      "sent_at": 1783512159,
      "conversation_id": "18",
      "brand_id": 5182,
      "account_id": 1001
    }
  },
  "webhookMetadata": {
    "webhookTargetId": "36",
    "deliveryAttemptId": "019f419bd7097f2ca7e5eb48b97b3993",
    "deliveryAttemptNumber": 1
  }
}
```

## Payload fields

| Field                  | Type   | Description                                                                                                                                                                                                          |
| ---------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `conversation_message` | object | The note that was added. See the field reference on [`conversation.agent.replied`](/webhooks/events/conversation-agent-replied#the-conversation_message-object). The `author` is the team member who wrote the note. |

## Related events

* [`conversation.agent.replied`](/webhooks/events/conversation-agent-replied) — an agent replies to the customer
* [`conversation.user.replied`](/webhooks/events/conversation-user-replied) — a customer replies