KNknotapi

Create Webhook Endpoint

Changed on

Create a webhook endpoint. Up to 10 per environment.

post/webhook-endpoints/create

Request

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

Request body

environment'development' | 'production' required

The environment the webhook endpoint belongs to. Must match your access token's environment.

urlstring uri required

The URL Knot sends webhooks to. Must be a public https URL. Max 2083 characters.

descriptionstring

A description of the webhook endpoint. Max 255 characters.

Example request

{
  "environment": "development",
  "url": "https://example.com/webhooks/knot",
  "description": "Primary webhook listener"
}

Response

Successful request.

idstring

Unique identifier for the webhook endpoint.

urlstring

The URL Knot sends webhooks to.

descriptionstring nullable

A description of the webhook endpoint, or null if none.

environment'development' | 'production'

The environment the webhook endpoint belongs to.

created_atstring date-time

When the webhook endpoint was created, in ISO 8601 format.

Example response

{
  "id": "0a8f5c6e-3d2b-4e1a-9f7c-8b6d5e4c3a21",
  "url": "https://example.com/webhooks/knot",
  "description": "Primary webhook listener",
  "environment": "development",
  "created_at": "2026-10-01T14:32:08Z"
}

Changes