---
title: "Register a webhook for a client"
method: POST
path: "/v1/clients/{clientId}/webhooks"
---

# Register a webhook for a client

`POST /v1/clients/{clientId}/webhooks`

Endpoint to register a new URL where the specified client will receive webhooks. Requires `Authorization: Bearer <token>` headers.

## Path parameters

- `clientId` string, uuid, required

## Request body

- CreateWebhookRequest
  - `client_id` string, required
  - `url` string, uri, required
  - `token` string, required
  - `webhook_type` 'MONEY_IN' | 'STATUS_UPDATE' | 'CEP' | 'REPORT', required

## Response `200`

Webhook successfully created

- WebhookResponse
  - `id` string
  - `clientId` string
  - `url` string
  - `token` string
  - `webhookType` string
  - `webhookStatus` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `deletedAt` string, nullable
  - `blockedAt` string, nullable
  - `deletedBy` string, nullable
  - `blockedBy` string, nullable

---

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