System

Note created

note.created

Fires when an internal note is added to a conversation. Notes are visible to company staff only and are never delivered to the customer.

HTTP request

AISAR sends a signed POST request to your webhook_url:

http

POST {webhook_url}
Content-Type: application/json
X-AISAR-Signature: sha256=...

{
  "event": "note.created",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "note": {
      "id": 1,
      "conversation_id": 45,
      "content": "Customer called to follow up.",
      "author": {
        "user_id": 3,
        "name": "Manager Name"
      },
      "created_at": "2026-03-26T12:00:00.000000Z"
    }
  }
}

The X-AISAR-Signature header carries an HMAC-SHA256 signature of the request body — use it to verify the request came from AISAR.

Example payload

json

{
  "event": "note.created",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "note": {
      "id": 1,
      "conversation_id": 45,
      "content": "Customer called to follow up.",
      "author": {
        "user_id": 3,
        "name": "Manager Name"
      },
      "created_at": "2026-03-26T12:00:00.000000Z"
    }
  }
}

Payload fields

Field	Type	Description
`note.id`	`integer`	Note ID
`note.conversation_id`	`integer`	Conversation the note belongs to
`note.content`	`string`	Note text content
`note.author`	`object\|null`	User who created the note
`note.author.user_id`	`integer`	Author user ID
`note.author.name`	`string`	Author full name
`note.created_at`	`string`	ISO 8601 timestamp