---
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

---

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