---
title: "Create a webhook endpoint"
method: POST
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Create a webhook endpoint

`POST /v1/webhooks`

Register a webhook endpoint. Didit ID signs every delivery with the returned secret using HMAC-SHA256 and sends the `X-Didit-Signature` and `X-Didit-Timestamp` headers (see the signature-verification note below). Save the returned `secret` — it is only shown once. Provide `subscribed_events` to filter, or omit it to receive every event type.

## Request body

- object
  - `label` string, required — You set a human-readable label for the endpoint.
  - `url` string, uri, required — You set the destination URL (http or https) that receives POST deliveries.
  - `subscribed_events` string[] — You optionally set the event types to deliver. Omit or send an empty array to receive every event type.
  - `enabled` boolean — You optionally set whether the endpoint is active. Defaults to `true`.

## Response `201`

The webhook endpoint was created. The full signing secret is returned once.

- object
  - `id` string, uuid — You receive the UUID for this webhook endpoint.
  - `label` string — You receive the endpoint label.
  - `url` string, uri — You receive the destination URL that receives POST deliveries.
  - `secret` string — You receive the full signing secret. Store it now — subsequent reads mask it.
  - `subscribed_events` string[] — You receive the event types this endpoint is subscribed to. An empty array means all event types are delivered.
  - `enabled` boolean — You receive `true` when the endpoint is active and receiving deliveries.
  - `created_at` string, date-time — You receive the timestamp when the endpoint was created.
  - `updated_at` string, date-time — You receive the timestamp when the endpoint was last updated.

---

[API](https://skmtc.net/didit-protocol/apis/didit-credentials-api.md) · [All operations](https://skmtc.net/didit-protocol/apis/didit-credentials-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/didit-protocol/didit-credentials-api/revisions/e4eddba66557/schema)