Webhook

イベント

利用可能なすべてのWebhookイベントタイプとペイロード構造。

イベントエンベロープ

すべてのイベントは同じエンベロープでラップされます：

json

{
  "id": "evt_abc123",
  "type": "user.created",
  "createdAt": "2026-01-15T10:30:00Z",
  "projectId": "proj_abc123",
  "data": { ... }  // event-specific payload
}

ユーザーイベント

user.created

新しいユーザーが初めてサインアップしたときに発火します。

event.data

json

{
  "user": {
    "id": "usr_abc123",
    "email": "user@example.com",
    "displayName": "John Doe",
    "provider": "google",
    "createdAt": "2026-01-15T10:30:00Z"
  }
}

user.updated

ユーザープロファイルが更新されたときに発火します。

event.data

json

{
  "user": { ... },
  "changes": ["displayName", "avatarUrl"]
}

user.deleted

ユーザーアカウントが完全に削除されたときに発火します。

event.data

json

{
  "userId": "usr_abc123",
  "email": "user@example.com"
}

user.banned

ユーザーがBANされたときに発火します。すべてのセッションが失効します。

event.data

json

{
  "user": {
    "id": "usr_abc123",
    "email": "user@example.com"
  },
  "bannedBy": "admin",
  "bannedAt": "2026-01-15T10:30:00Z"
}

user.unbanned

ユーザーのBANが解除されたときに発火します。

event.data

json

{
  "user": {
    "id": "usr_abc123",
    "email": "user@example.com"
  }
}

セッションイベント

session.created

ユーザーがサインインして新しいセッションが作成されたときに発火します。

event.data

json

{
  "session": {
    "id": "sess_abc123",
    "userId": "usr_abc123",
    "ipAddress": "203.0.113.1",
    "userAgent": "Mozilla/5.0...",
    "createdAt": "2026-01-15T10:30:00Z"
  },
  "user": { ... }
}

session.ended

セッションが期限切れまたはユーザーが正常にサインアウトしたときに発火します。

event.data

json

{
  "session": {
    "id": "sess_abc123",
    "userId": "usr_abc123",
    "endedAt": "2026-01-16T10:30:00Z",
    "reason": "expired"
  }
}

session.revoked

ダッシュボードからセッションが強制的に失効されたときに発火します。

event.data

json

{
  "session": {
    "id": "sess_abc123",
    "userId": "usr_abc123",
    "revokedAt": "2026-01-15T11:00:00Z",
    "reason": "admin_revoke"
  }
}

プロバイダーイベント

provider.linked

ユーザーがアカウントに新しいOAuthプロバイダーを連携したときに発火します。

event.data

json

{
  "userId": "usr_abc123",
  "provider": "github",
  "linkedAt": "2026-01-15T10:30:00Z"
}

provider.unlinked

ユーザーがOAuthプロバイダーの連携を解除したときに発火します。

event.data

json

{
  "userId": "usr_abc123",
  "provider": "github",
  "unlinkedAt": "2026-01-15T10:30:00Z"
}