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

# Create a new webhook subscription

`POST /webhooks`

Creates a new webhook subscriber with subscription for the specified events.

## Request body

- CreateWebhookRequest
  - `url` string, uri, required — The HTTPS URL that will receive webhook events
  - `signatureKey` string — The optional key used to sign the webhook events
  - `description` string — Optional description of the webhook subscription
  - `eventNames` string[], required — The names of the events to subscribe to

## Response `200`

Webhook subscription created successfully

- WebhookCreationResponse
  - `id` string, required — The id of the created webhook subscription

## Other responses

- `400` — The request was invalid or cannot be served
- `401` — Authentication information is missing or invalid
- `500` — An unexpected error occurred on the server

---

[API](https://skmtc.net/sysaid/apis/sysaid-public-api.md) · [All operations](https://skmtc.net/sysaid/apis/sysaid-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sysaid/sysaid-public-api/revisions/38a43a1b2981/schema)