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}

Request

Base URL
https://api.muralpay.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/muralpay/apis/mural-api/docs/api/webhooks/:webhookId/patch.ts
A function with typed inputs. Its response is checked against the schema.

webhookIdstring required

Webhook ID

categoriesstring[]

Event categories to subscribe to

urlstring

HTTPS URL endpoint where webhook events will be delivered

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

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