---
title: Webhook events
---

# Webhook event reference

All events share the envelope:

```json
{
  "id": "evt_8c5e4e2a",
  "event": "<event-type>",
  "created_at": "2026-05-03T10:00:00Z",
  "client_id": "your-client-id",
  "data": { /* event-specific */ }
}
```

For delivery, signing, and retry semantics see the [Webhooks guide](../guides/webhooks.md).

## `account.signed_in`

```json
{
  "data": {
    "account": "Bootim",
    "scopes": ["openid","profile","email"],
    "auth_method": "password" | "google" | "facebook" | "twitter" | "linkedin" | "autol",
    "ip": "203.0.113.42",
    "user_agent": "Mozilla/5.0...",
    "session_id": "ses_2x9..."
  }
}
```

## `account.signed_out`

```json
{
  "data": {
    "account": "Bootim",
    "session_id": "ses_2x9...",
    "initiated_by": "user" | "rp" | "admin"
  }
}
```

## `account.consent_granted`

```json
{
  "data": {
    "account": "Bootim",
    "scopes": ["openid","profile","email","offline_access"]
  }
}
```

## `account.consent_revoked`

```json
{
  "data": {
    "account": "Bootim",
    "scopes": ["offline_access"]
  }
}
```

## `account.linked`

```json
{
  "data": {
    "account": "Bootim",
    "provider": "google",
    "provider_subject": "117934...",
    "email": "you@example.org"
  }
}
```

## `account.unlinked`

```json
{
  "data": {
    "account": "Bootim",
    "provider": "google"
  }
}
```

## `account.deleted`

```json
{
  "data": {
    "account": "Bootim",
    "deleted_at": "2026-05-03T10:00:00Z",
    "reason": "user_request" | "admin_action" | "policy_violation"
  }
}
```

## `tokens.revoked`

```json
{
  "data": {
    "account": "Bootim",
    "token_type": "access_token" | "refresh_token",
    "reason": "user_logout" | "rp_revoke" | "rotation_replay" | "admin"
  }
}
```