---
title: "Create a new database webhook"
method: POST
path: "/webhooks"
---

# Create a new database webhook

`POST /webhooks`

## Request body

- Webhook
  - `callback` string, uri, required
  - `events` string[], required

## Response `201`

Created

- DatabaseWebhook
  - `id` string, uuid
  - `callback` string, uri
  - `enabled` boolean
  - `failures` integer
  - `expires_at` string, date-time
  - `events` DatabaseWebhookEvent[]
    - `id` string, uuid
    - `event` 'user' | 'user.login' | 'user.create' | 'user.delete' | 'user.update' | 'user.update.email' | 'user.update.email.create' | 'user.update.email.delete' | 'user.update.email.primary' | 'user.update.username' | 'user.update.username.create' | 'user.update.username.delete' | 'user.update.username.update' | 'email.send'
  - `created_at` string, date-time
  - `updated_at` string, date-time — Time of last update of the audit log

## Other responses

- `400` — Bad Request
- `500` — Internal server error

---

[API](https://skmtc.net/hanko/apis/hanko-admin-api.md) · [All operations](https://skmtc.net/hanko/apis/hanko-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hanko/hanko-admin-api/versions/d22a127b0978/schema)