Webhooks

Delete a client webhook

Changed on Sep 26, 2026

Deletes (or soft-deletes) a webhook owned by the client.

delete/v1/clients/{clientId}/webhooks/{id}

Request

Base URL
https://apicore.stg.finch.lat
Auth
HTTP bearer
TypeScript
https://skmtc.dev/monato/apis/fincore-api/docs/v1/clients/:clientId/webhooks/:id/delete.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

clientIdstring uuid required

Client UUID that owns the webhook.

idstring uuid required

Webhook UUID.

Response

Webhook successfully deleted

idstring uuid required

Webhook configuration UUID.

clientIdstring uuid required

Client UUID that owns the webhook.

urlstring uri required

Destination URL where Monato sends webhook events.

tokenstring

Secret configured for webhook delivery.

webhookType'MONEY_IN' | 'STATUS_UPDATE' | 'CEP' | 'REPORT' | 'REFUND' required

webhookStatus'ACTIVE' | 'INACTIVE' required

createdAtstring date-time

Timestamp when the webhook configuration was created.

updatedAtstring date-time

Timestamp when the webhook configuration was last updated.

deletedAtstring nullable

Timestamp when the webhook configuration was deleted, or null.

blockedAtstring nullable

Timestamp when the webhook configuration was blocked, or null.

deletedBystring nullable

Identifier of the actor that deleted the webhook, or null.

blockedBystring nullable

Identifier of the actor that blocked the webhook, or null.

Example response

{
  "id": "29806117-2b15-4682-87f0-350e6695fe91",
  "clientId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
  "url": "https://example.com/webhook",
  "token": "secretToken0123",
  "webhookType": "MONEY_IN",
  "webhookStatus": "ACTIVE",
  "createdAt": "2025-04-03 13:40:54.056794-06:00",
  "updatedAt": "2025-04-03 13:40:54.056794-06:00"
}

Changes

Sep 26, 2026e22ef66945df Revision changes
- warning
  added the new ACTIVE enum value to the response property for the response status
- warning
  added the new CEP enum value to the response property for the response status
- warning
  added the new INACTIVE enum value to the response property for the response status
- warning
  added the new MONEY_IN enum value to the response property for the response status
- warning
  added the new REFUND enum value to the response property for the response status
- warning
  added the new REPORT enum value to the response property for the response status
- warning
  added the new STATUS_UPDATE enum value to the response property for the response status
- info
  api tag Webhooks added
- info
  added the media type application/json for the response with the status
- info
  added the non-success response with the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status

Operation history