---
title: "Create webhook"
method: POST
path: "/webhooks"
---

# Create webhook

`POST /webhooks`

## Request body

- CreateWebhookParams
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `name` string, required — The name of the webhook.
  - `url` string, required — The webhook URL.

## Response `201`

Created

- CreateWebhookResponse
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `signing_key` string, required
  - `webhook` Webhook, required
    - `account_id` string, byte, required
    - `created_at` string, date-time, required
    - `created_by_id` string, byte, required
    - `deleted_at` string, date-time
    - `last_checked_at` string, date-time, nullable, required
    - `name` string, required
    - `state` 'healthy' | 'unhealthy' | 'unknown', required
    - `url` string, required

## Other responses

- `default` — Error

---

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