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

# Create webhook endpoint

`POST /v1/webhooks/endpoints`

Create a new webhook endpoint.

## Request body

- object
  - `description` string — Webhook endpoint description.
  - `url` string, uri, required — Webhook endpoint URL.
  - `secret` string — Webhook endpoint verification secret (base64 encoded random bytes). If not defined, a secret is automatically generated and only accessible in the UI.
  - `rate_limit` number — Webhook rate limit (per second).
  - `event_types` string[] — Webhook event types filter. If not defined, all event messages will be sent.

## Response `201`

- WebhookEndpoint
  - `id` string, required — Webhook endpoint ID.
  - `description` string, required — Webhook endpoint description.
  - `url` string, uri, required — Webhook endpoint URL.
  - `rate_limit` number, nullable, required — Webhook rate limit (per second).
  - `event_types` string[], nullable, required — Webhook event types filter. If not defined, all event messages will be sent.
  - `created_at` string, date-time, required — Webhook creation date.

---

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