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

# Create a new webhook endpoint

`POST /v1/webhooks/endpoints`

Create a new webhook endpoint to receive events.

## Headers

- `X-API-Key` string

## Request body

- CreateEndpointDto
  - `url` string, uri, required — The webhook endpoint URL
  - `description` string, required — Description of the endpoint
  - `filterTypes` string[] — Event types to send to this endpoint. Omit or pass an empty array to subscribe to all event types.
  - `metadata` object — Optional endpoint metadata

## Response `201`

Webhook endpoint created successfully

- EndpointResponseDto
  - `id` string, required — Endpoint ID
  - `url` string, required — The webhook endpoint URL
  - `description` string, required — Description of the endpoint
  - `filterTypes` string[], required — Event types sent to this endpoint. An empty array means the endpoint is subscribed to all event types.
  - `disabled` boolean, required — Whether the endpoint is disabled
  - `createdAt` string, required — Endpoint creation timestamp
  - `updatedAt` string, required — Endpoint last update timestamp
  - `metadata` object — Optional endpoint metadata

## Other responses

- `401` — Unauthorized - Invalid or missing authentication credentials

---

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