conversation.note.created/1

Internal note added. A staff member (or the API) added an internal note. Notes are never shown to the customer.

Payload

We POST this JSON to your endpoint. Answer any 2xx within 30 seconds. The same id arrives again on a retry — skip ones you have handled.

Payload fields
Field	Type	What it is
idrequired	string	Event id. The same on every retry: use it to skip duplicates.pattern `^evt_[0-9A-HJKMNP-TV-Z]{26}$`
typerequired	string	Event type.always `conversation.note.created`
versionrequired	string	Payload version.always `1`
api_versionrequired	string	The endpoint's API version.
occurred_atrequired	string	When it happened.date-time
company_idrequired	integer	Your workspace id.
datarequired	object
idrequired	integer	Note id.
conversationrequired	object
idrequired	integer	Conversation id.
company_idrequired	integer	Workspace id.
staff	object or null	Who wrote it.
idrequired	integer	Id.
namerequired	string or null	Name.
bodyrequired	string	The note text.
created_at	string or null	ISO 8601.

Example

{
  "id": "evt_01J8Z7BZQ4F6G8J2K5N7Q9S1VC",
  "type": "conversation.note.created",
  "version": "1",
  "api_version": "2026-10-01",
  "occurred_at": "2026-09-24T09:20:00Z",
  "company_id": 1001,
  "data": {
    "id": 90331,
    "conversation": {
      "id": 77410,
      "company_id": 1001
    },
    "staff": {
      "id": 1203,
      "name": "Priya Nair"
    },
    "body": "Customer asked for a refund; ticket #4411.",
    "created_at": "2026-09-24T09:20:00Z"
  }
}

Headers

Webhook-Signature: t=…,v1=… — how to check it
Webhook-Id (also Webhook-Event-Id): the event id, the same on every retry — skip ones you have handled
Webhook-Delivery-Id: this delivery attempt, new on every try

API calls that can cause it

Add an internal note