---
title: "Create Webhook"
method: POST
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Create Webhook

`POST /v1/webhooks`

Register a webhook endpoint. Response includes the signing
secret EXACTLY ONCE -- store it on the customer side before
closing the response. We persist only its peppered hash.

400 on:
  - unknown event type
  - duplicate (customer_id, url) -- they already have one for
    that URL; DELETE the old one first or just keep using it

## Headers

- `X-Api-Key` string

## Request body

- CreateWebhookRequest
  - `url` string, uri, required
  - `events` string[]
  - `label` string

## Response `201`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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