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

# Create a webhook

`POST /webhooks`

Create a new webhook.

## Request body

- CreateWebhookRequest
  - `description` string — Human-readable purpose of the webhook.
  - `url` string, required — HTTPS URL that receives webhook deliveries; IP addresses are rejected.

## Response `201`

Created

- WebhookWithSecret
  - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
  - `description` string, nullable, required — Webhook purpose.
  - `id` string, required — Unique resource identifier.
  - `is_active` boolean, required — Whether the webhook is active.
  - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
  - `secret` string, required — Signing secret returned when the webhook is created.
  - `url` string, required — Webhook destination URL.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/joinsophic/apis/sophic-engine-api.md) · [All operations](https://skmtc.net/joinsophic/apis/sophic-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joinsophic/sophic-engine-api/revisions/5b4c43e2941b/schema)