API 레퍼런스

웹훅

인증 이벤트 발생 시 실시간 알림을 수신하는 웹훅 엔드포인트를 관리합니다.

Webhook 객체

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

웹훅 목록

현재 프로젝트의 모든 웹훅 엔드포인트를 나열합니다.

응답

json

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

POST/v1/dashboard/webhooks

웹훅 생성

새 웹훅 엔드포인트를 생성합니다.

요청 본문

json

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

응답

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

웹훅 삭제

웹훅 엔드포인트를 삭제합니다.

응답

json

{ "success": true }