v1

latestOpenAPI 3.0.02026-07-2464438356.8 KB
Webhooks

Update webhook

Partially updates webhook configuration. Only provided fields will be updated. Use the separate status endpoint to activate/deactivate webhooks.

patch/api/webhooks/{webhookId}

Path parameters

webhookIdstring required

Webhook ID

Request body

categoriesstring[]

Event categories to subscribe to

urlstring

HTTPS URL endpoint where webhook events will be delivered

Example request

{
  "categories": [
    "MURAL_ACCOUNT_BALANCE_ACTIVITY"
  ],
  "url": "https://api.example.com/webhooks"
}

Response

Webhook updated successfully

categoriesstring[] required

Event categories this webhook is subscribed to

createdAtstring date-time required

When the webhook was created

idstring required

Unique webhook identifier

publicKeystring required

ECDSA public key in PEM format for signature verification

status'DISABLED' | 'ACTIVE' required

Webhook status

updatedAtstring date-time required

When the webhook was last updated

urlstring required

Webhook endpoint URL

versionnumber required

Webhook version for tracking changes