System

Notification created

notification.created

Fires when a notification is created for a user (assignment, mention, system alert). It is delivered on the user-specific WebSocket channel rather than the company channel and is typically used for in-app notification badges and real-time alerts.

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": "notification.created",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T10:00:00.000000Z",
  "company_id": 1,
  "data": {
    "notification": {
      "id": 200,
      "type": "conversation.assigned",
      "title": "Conversation assigned to you",
      "user_id": 3
    }
  }
}

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": "notification.created",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T10:00:00.000000Z",
  "company_id": 1,
  "data": {
    "notification": {
      "id": 200,
      "type": "conversation.assigned",
      "title": "Conversation assigned to you",
      "user_id": 3
    }
  }
}

Payload fields

Field	Type	Description
`notification.id`	`integer`	Notification ID
`notification.type`	`string`	Notification type (mirrors the triggering event, e.g. `conversation.assigned`)
`notification.title`	`string`	Short notification title
`notification.user_id`	`integer`	ID of the user this notification is for