---
title: "Create Webhook"
method: POST
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Create Webhook

`POST /v1/webhooks`

## Request

- Base URL: `https://api.pinbridge.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pinbridge.io/v1/webhooks`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Create a new webhook endpoint.

Webhooks receive events like pin.published and pin.failed.

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- WebhookCreate: Request schema for creating a webhook.
  - `url` string, uri, required: Webhook endpoint URL
  - `secret` string, required: Secret for HMAC signing (min 16 chars)
  - `events` string[]: Event types to subscribe to
  - `is_enabled` boolean: Whether this webhook is active

## Response `201`

Successful Response

- WebhookResponse: Response schema for a webhook.
  - `id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `url` string, required
  - `events` string[], required
  - `is_enabled` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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