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

# Create webhook

`POST /api/webhooks`

## Request body

- object
  - `name` string, required
  - `url` string, uri, required
  - `events` string[]
  - `generate_secret` boolean

## Response `200`

Webhook created. Secret is only shown in full on creation.

- object
  - `id` integer
  - `name` string
  - `url` string
  - `secret` string
  - `events` string[]
  - `enabled` boolean
  - `message` string

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `429` — Rate limit exceeded

## Changes

> 27 revisions in range; 1 could not be searched.

- **2026-03-02** `39aff788d955` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/builderz-labs/apis/mission-control-api/changes/api/webhooks/post.md)

---

[API](https://skmtc.dev/builderz-labs/apis/mission-control-api.md) · [All operations](https://skmtc.dev/builderz-labs/apis/mission-control-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/builderz-labs/mission-control-api/revisions/b920835b2793/schema)