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

# Create a webhook endpoint

`POST /v1/webhooks/endpoints`

Register a URL to receive webhook events, and choose which events to subscribe to. The signing secret is returned once in the response. Requires the `webhooks:write` scope.

## Request body

- CreateWebhookEndpointRequest — Parameters for creating a webhook endpoint.
  - `name` string, required — A label for the endpoint.
  - `url` string, uri, required — The HTTPS URL Bachs should deliver events to.
  - `event_types` string[], required — The events to subscribe to. At least one is required.

## Response `201`

The created endpoint, including its signing secret.

- CreateWebhookEndpointResponse — The created endpoint, plus its signing secret. The secret is returned only once, on creation. Store it securely.
  - `endpoint_id` string, required — Unique identifier for the endpoint.
  - `name` string, required — A label for the endpoint.
  - `url` string, uri, required — The HTTPS URL events are delivered to.
  - `enabled` boolean, required — Whether the endpoint is active and receiving events.
  - `event_types` string[], required — The events this endpoint is subscribed to.
  - `created_at` string, required — When the endpoint was created, in UTC.
  - `updated_at` string, required — When the endpoint was last updated, in UTC.
  - `signing_secret` string, required — The secret used to sign deliveries to this endpoint. Shown only here, on creation. Use it to verify the `X-Bachs-Signature` header.

---

[API](https://skmtc.dev/bachs/apis/bachs-api.md) · [All operations](https://skmtc.dev/bachs/apis/bachs-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bachs/bachs-api/revisions/f29efa8a22df/schema)