---
title: "Create Webhook"
method: POST
path: "/api/v1/cash/webhooks"
---

# Create Webhook

`POST /api/v1/cash/webhooks`

Allows authenticated clients to configure webhook endpoints for receiving real-time
notifications about operation status changes. The webhook is only activated if the activation test is successful.

**Webhook Events**: After configuration, your endpoint will receive:
- Activation test: See `WebhookActivationEvent` schema below
- Status updates: See `OperationStatusUpdateEvent` schema below

**Note**: Only one active webhook is allowed per client. Creating a new webhook will deactivate any existing ones after successful activation.

## Headers

- `X-Client-Id` string, required
- `X-Signature` string, required
- `X-Timestamp` string, required

## Request body

- WebhookConfigRequest
  - `endpoint_url` string, uri, required — The webhook endpoint URL where notifications will be sent (must use http or https protocol)

## Response `201`

Webhook configured successfully. An activation test will be sent to your endpoint.
The webhook will be marked as active only if your endpoint responds successfully to the test.

- WebhookConfigResponse
  - `event` 'webhook.created' — Event type identifier
  - `id` integer — Unique identifier for the webhook configuration
  - `endpoint_url` string, uri — The configured webhook endpoint URL
  - `secret_token` string — 64-character hexadecimal secret token for webhook signature verification
  - `created_at` string, date-time — ISO 8601 timestamp of webhook configuration creation

## Other responses

- `400` — Bad Request - Invalid webhook configuration
- `401` — Unauthorized - Invalid or missing authentication

---

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