---
title: "Create Endpoint"
method: POST
path: "/api/v1/webhooks/endpoints"
tags: ["External: Webhooks"]
---

# Create Endpoint

`POST /api/v1/webhooks/endpoints`

## Request body

- EndpointCreateRequest
  - `url` string, required — HTTPS URL where webhook payloads will be sent.
  - `description` string, nullable — Human-readable label for this endpoint.
  - `filter_types` string[], nullable — Only deliver events of these types. Empty / None = all types.
  - `user_id` string, uuid, nullable — Subscribe only to events for this user. Empty / None = all users.

## Response `201`

Successful Response

- EndpointResponse
  - `id` string, required
  - `url` string, required
  - `description` string, nullable
  - `filter_types` string[], nullable
  - `user_id` string, uuid, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/openwearables/apis/open-wearables-api.md) · [All operations](https://skmtc.net/openwearables/apis/open-wearables-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openwearables/open-wearables-api/versions/37c1c527cd8f/schema)