conversation.note.added
Fires when an internal note is added to a SparrowDesk conversation
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.
Example payload
{
"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": "[email protected]",
"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. The author is the team member who wrote the note. |
Related events
conversation.agent.replied— an agent replies to the customerconversation.user.replied— a customer replies