---
title: "Create a webhook configuration"
method: POST
path: "/configurations"
tags: ["Webhook Configuration Operations"]
---

# Create a webhook configuration

`POST /configurations`

Creates a webhook configuration.

## Request body

- WebhookConfiguration — A webhook configuration
  - `id` string — identifier of the webhook configuration. autogenerated during create webhook configuration operation
  - `name` string, required — identifying name of the webhook configuration
  - `enabled` boolean — whether the webhook configuration is enabled. this allows executing a webhook call in case a new event is triggered
  - `url` string, required — url of the webhook call
  - `method` 'POST', required — HTTP Method * POST - POST operation
  - `triggers` WebhookConfigurationTrigger[], required — events that triggers webhook calls
  - `headers` WebhookConfigurationHeader[] — headers used in webhook calls
    - `name` string, required — identifying name of the webhook configuration header
    - `value` boolean, required — value of te webhook configuration header
    - `secret` boolean — whether the webhook configuration header contains a secret value
  - `system` System — System properties
    - `createdBy` string — the name of the user that created the webhook configuration
    - `createdAt` string, date-time — date of create
    - `updatedBy` string — the name of the user that updated the webhook configuration
    - `updatedAt` string, date-time — date of update

## Response `200`

OK

- WebhookConfiguration — A webhook configuration
  - `id` string — identifier of the webhook configuration. autogenerated during create webhook configuration operation
  - `name` string, required — identifying name of the webhook configuration
  - `enabled` boolean — whether the webhook configuration is enabled. this allows executing a webhook call in case a new event is triggered
  - `url` string, required — url of the webhook call
  - `method` 'POST', required — HTTP Method * POST - POST operation
  - `triggers` WebhookConfigurationTrigger[], required — events that triggers webhook calls
  - `headers` WebhookConfigurationHeader[] — headers used in webhook calls
    - `name` string, required — identifying name of the webhook configuration header
    - `value` boolean, required — value of te webhook configuration header
    - `secret` boolean — whether the webhook configuration header contains a secret value
  - `system` System — System properties
    - `createdBy` string — the name of the user that created the webhook configuration
    - `createdAt` string, date-time — date of create
    - `updatedBy` string — the name of the user that updated the webhook configuration
    - `updatedAt` string, date-time — date of update

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `409` — Conflict

---

[API](https://skmtc.net/bloomreach/apis/documents-delivery-api-2-0.md) · [All operations](https://skmtc.net/bloomreach/apis/documents-delivery-api-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bloomreach/documents-delivery-api-2-0/revisions/87bfc06578c2/schema)