---
title: "Create webhook subscription"
method: POST
path: "/v1/webhooks"
tags: ["webhooks"]
---

# Create webhook subscription

`POST /v1/webhooks`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/webhooks`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Register a URL to receive event notifications. Returns the signing secret (shown only once).

## Request body

- WebhookCreate
  - `url` string, required: HTTPS endpoint URL to receive events
  - `events` string[], nullable: Event types to subscribe to (default: all)
  - `description` string, nullable: Human-readable description

## Response `200`

Webhook created with signing secret

- unknown

## Other responses

- `400`: Invalid URL or event types
- `422`: Validation Error

---

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