---
title: "Create Webhook Endpoint"
method: POST
path: "/webhook-endpoints/create"
---

# Create Webhook Endpoint

`POST /webhook-endpoints/create`

## Request

- Base URL: `https://api.dashboard.knotapi.com`
- URL: `https://api.dashboard.knotapi.com/webhook-endpoints/create`
- Auth: HTTP bearer

Create a webhook endpoint. Up to 10 per environment.

## Request body

- object
  - `environment` 'development' | 'production', required: The environment the webhook endpoint belongs to. Must match your access token's environment.
  - `url` string, uri, required: The URL Knot sends webhooks to. Must be a public `https` URL. Max 2083 characters.
  - `description` string: A description of the webhook endpoint. Max 255 characters.

## Response `200`

Successful request.

- WebhookEndpoint
  - `id` string: Unique identifier for the webhook endpoint.
  - `url` string: The URL Knot sends webhooks to.
  - `description` string, nullable: A description of the webhook endpoint, or `null` if none.
  - `environment` 'development' | 'production': The environment the webhook endpoint belongs to.
  - `created_at` string, date-time: When the webhook endpoint was created, in ISO 8601 format.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized request.
- `403`: Forbidden request.
- `429`: Too many requests.
- `500`: Internal server error.

## Changes

- **2026-11-03** `f10ecfa12c00`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/knotapi/apis/knot-api/changes/webhook-endpoints/create/post.md)

---

[API](https://skmtc.dev/knotapi/apis/knot-api.md) - [All operations](https://skmtc.dev/knotapi/apis/knot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knotapi/apis/knot-api/revisions/f10ecfa12c00?raw)