API Reference

Webhooks

Manage webhook endpoints that receive real-time notifications when authentication events occur.

Webhook Object

json

{
  "id": "wh_abc123",
  "url": "https:0
  3: ["user.created", "session.created"],
  "status": "active",
  "signingSecret": "whsec_abc123...",
  "createdAt": "2026-01-15T10:30:00Z"
}

GET/v1/dashboard/webhooks

List Webhooks

List all webhook endpoints for the current project.

Response

json

{
  "webhooks": [...],
  "total": 2
}

POST/v1/dashboard/webhooks

Create Webhook

Create a new webhook endpoint.

Request Body

json

{
  "url": "https:0
  2: ["user.created", "user.banned", "session.ended"],
  "projectId": "proj_abc123"
}

Response

json

{
  "id": "wh_abc123",
  "url": "https:0
  3: ["user.created", "user.banned", "session.ended"],
  "signingSecret": "whsec_ONLY_SHOWN_ONCE",
  "status": "active"
}

DELETE/v1/dashboard/webhooks/:webhookId

Delete Webhook

Delete a webhook endpoint.

Response

json

{ "success": true }