---
title: "Create a new webhook connector configuration"
method: POST
path: "/api/v1/inbound_webhooks"
tags: ["Inbound Webhook Management"]
---

# Create a new webhook connector configuration

`POST /api/v1/inbound_webhooks`

Creates a webhook connector configuration used by the generic inbound webhook endpoint

## Request body

- InboundWebhookCreateDtoIn
  - `identifier` string, required
  - `name` string, required
  - `description` string
  - `enabled` boolean
  - `mapping_identifiers` string[]
  - `security` InboundWebhookSecurityContractDtoIn
    - `type` string, required
    - `config` object, required

## Response `201`

Webhook connector created

## Other responses

- `400` — Invalid webhook connector data provided
- `409` — Webhook connector already exists in this entityTemplateIdentifier

## Changes

- **2026-08-26** `e6f6d45eade3` — 3 info
  - added the optional property `mappings/items/action` to the response with the `201` status
  - added the optional property `mappings/items/action` to the response with the `400` status
  - added the optional property `mappings/items/action` to the response with the `409` status
- **2026-08-05** `00ae15bb3a81` — 3 breaking
  - the `mappings/items/entity/relations` response's property type/format changed from `object`/`` to `array`/`` for status `201`
  - the `mappings/items/entity/relations` response's property type/format changed from `object`/`` to `array`/`` for status `400`
  - the `mappings/items/entity/relations` response's property type/format changed from `object`/`` to `array`/`` for status `409`
- **2026-07-16** `584ac64069cc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/decathlon/apis/idp-core-api/changes/api/v1/inbound_webhooks/post.md)

---

[API](https://skmtc.dev/decathlon/apis/idp-core-api.md) · [All operations](https://skmtc.dev/decathlon/apis/idp-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decathlon/idp-core-api/revisions/5081d87614ba/schema)