---
title: "Update an existing webhook subscription."
method: PUT
path: "/webhooks/{id}"
tags: ["Webhooks"]
---

# Update an existing webhook subscription.

`PUT /webhooks/{id}`

## Request

- Base URL: `https://collectionpartner-api.debitura.com`
- URL: `https://collectionpartner-api.debitura.com/webhooks/{id}`
- Auth: API key in header `XApiKey`

Updates webhook URL, events, or active status. Set RegenerateSecret=true to rotate signing secret (returned in response). Use IsActive=true to re-enable auto-disabled webhooks after fixing delivery issues. Secret only included if RegenerateSecret=true.

## Path parameters

- `id` string, uuid, required

## Request body

- DebituraDomainModelWebhooksDtosUpdateWebhookRequest
  - `url` string, uri, nullable
  - `events` string[], nullable
  - `isActive` boolean, nullable
  - `regenerateSecret` boolean
  - `isTestMode` boolean, nullable

## Response `200`

Webhook updated successfully

- DebituraDomainModelWebhooksDtosWebhookDto
  - `id` string, uuid
  - `url` string, nullable
  - `events` string[], nullable
  - `isActive` boolean
  - `createdUtc` string, date-time
  - `updatedUtc` string, date-time
  - `disabledReason` string, nullable
  - `secret` string, nullable
  - `isTestMode` boolean

## Other responses

- `400`: Invalid request
- `401`: API key is missing or invalid
- `404`: Webhook not found

## Changes

- **2026-10-21** `a7cf0ff022b6`: 4 breaking
  - the `url` request property's maxLength was decreased to `800` (media type: application/json-patch+json)
  - the `url` request property's maxLength was decreased to `800` (media type: application/json)
  - the `url` request property's maxLength was decreased to `800` (media type: text/json)
  - the `url` request property's maxLength was decreased to `800` (media type: application/*+json)

[Operation history](https://skmtc.dev/debitura/apis/debitura-collection-partner-api/changes/webhooks/:id/put.md)

---

[API](https://skmtc.dev/debitura/apis/debitura-collection-partner-api.md) - [All operations](https://skmtc.dev/debitura/apis/debitura-collection-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/debitura/apis/debitura-collection-partner-api/revisions/a7cf0ff022b6?raw)