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

# Create Webhook

`POST /webhooks`

## Request

- Base URL: `https://api.feedback1.ai/api/v1`
- URL: `https://api.feedback1.ai/api/v1/webhooks`
- Auth: HTTP bearer

Create a new webhook.

The webhook secret is only returned once in this response.
Store it securely for signature verification.

## Request body

- WebhookCreate: Request to create a new webhook
  - `name` string, required: Name for the webhook
  - `url` string, uri, required: URL to send webhook events to
  - `events` string[], required: List of events to subscribe to
  - `product_ids` string[], nullable: Product IDs to filter events (null = all products)

## Response `201`

Successful Response

- WebhookCreated: Response after creating a webhook - includes the secret (only shown once!)
  - `id` string, required
  - `name` string, required
  - `url` string, required
  - `secret` string, required: Webhook secret for signature verification - SAVE THIS!
  - `events` string[], required
  - `product_ids` string[], nullable, required
  - `is_active` boolean, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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