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

# Create a webhook configuration

`POST /v1/settings/webhooks`

Create a new webhook configuration for a specified workspace.

## Headers

- `Workspace` string, required

## Request body

- CreateWebhookConfigurationRequest
  - `name` string, required — <placeholder>
  - `description` string — <placeholder>
  - `applyToAllDescendants` boolean, required — <placeholder>
  - `url` string, required — <placeholder>
  - `secret` string, required — <placeholder>
  - `headers` object — <placeholder>
  - `triggers` string[], required — <placeholder>

## Response `201`

Created

- WebhookConfigurationDto
  - `id` string
  - `name` string
  - `workspaceId` string
  - `status` 'enabled' | 'disconnected' | 'disabled' — <placeholder>
  - `description` string
  - `applyToAllDescendants` boolean
  - `url` string
  - `secret` string
  - `headers` object
  - `triggers` string[], required — <placeholder>
  - `created` integer
  - `updated` integer

## Other responses

- `400` — Bad request, validation error
- `401` — Unauthorized request
- `403` — Access forbidden
- `429` — Too Many Requests
- `500` — Internal server error

---

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