---
title: "Create a new webhook subscription."
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Create a new webhook subscription.

`POST /webhooks`

Creates a new webhook subscription for receiving real-time event notifications.

**Available Events (assigned/working-partner role):**
- `case.assigned` - Case validated by Debitura and assigned to your agency
- `case.updated` - Case lifecycle changed (e.g., Active → Paused). Does not cover engagement phase
  changes (Pre-legal/Legal/Enforcement) — poll `GET /cases/{id}` or `GET /cases/{id}/timeline` for
  the current phase; there is no phase-change event today.
- `case.closed` - Case closed
- `payment.created` - Payment registered on case
- `payment.deleted` - Payment reversed (deleted) on case
- `chat.created` - Chat message created on case

**Security:** Response includes Base64-encoded signing secret (shown only once). Store it to verify HMAC-SHA256 signatures on deliveries.

**Requirements:** HTTPS URL required. Deliveries retry with exponential backoff (8 attempts). Webhook auto-disables after max failures.

## Request body

- DebituraDomainModelWebhooksDtosCreateWebhookRequest
  - `url` string, uri, required
  - `events` string[], required
  - `isTestMode` boolean

## Response `201`

Webhook created 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
- `422` — Business rule violation

---

[API](https://skmtc.net/debitura/apis/debitura-collection-partner-api.md) · [All operations](https://skmtc.net/debitura/apis/debitura-collection-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debitura/debitura-collection-partner-api/revisions/d0dcc5024bd1/schema)