---
title: "Update an existing webhook connector by identifier"
method: PUT
path: "/api/v1/inbound_webhooks/{identifier}"
tags: ["Inbound Webhook Management"]
---

# Update an existing webhook connector by identifier

`PUT /api/v1/inbound_webhooks/{identifier}`

Update the details of an existing webhook connector identified by its unique string identifier

## Path parameters

- `identifier` string, required

## Request body

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

## Response `200`

Webhook connector updated successfully

## Other responses

- `400` — Invalid request payload
- `404` — Webhook connector not found with the provided identifier
- `409` — Webhook connector name already exists

## Changes

- **2026-08-26** `e6f6d45eade3` — 3 warning, 4 info
  - removed the optional property `errorDescription` from the response with the `400` status
  - removed the optional property `errorDescription` from the response with the `404` status
  - removed the optional property `errorDescription` from the response with the `409` status
  - added the optional property `error_description` to the response with the `400` status
  - …3 more
- **2026-08-05** `00ae15bb3a81` — 1 breaking
  - the `mappings/items/entity/relations` response's property type/format changed from `object`/`` to `array`/`` for status `200`
- **2026-07-16** `584ac64069cc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/decathlon/apis/idp-core-api/changes/api/v1/inbound_webhooks/:identifier/put.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)