Users & team

User invited

user.invited

Fires when an invitation is sent to a new user to join the company. Once the invitee accepts, a `user.invitation_accepted` event follows.

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": "user.invited",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "invitation": {
      "id": 12,
      "email": "newuser@company.kz",
      "role": "agent",
      "status": "pending"
    }
  }
}

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": "user.invited",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "invitation": {
      "id": 12,
      "email": "newuser@company.kz",
      "role": "agent",
      "status": "pending"
    }
  }
}

Payload fields

Field	Type	Description
`invitation.id`	`integer`	Invitation ID
`invitation.email`	`string`	Email the invitation was sent to
`invitation.role`	`string`	`admin` or `agent`
`invitation.status`	`string`	Always `pending` when first invited