Webhooks

Create webhook

Creates a new webhook endpoint in DISABLED state. Limited to 5 webhooks per organization.

post/api/webhooks

Request

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

categoriesstring[] required

Event categories to subscribe to

urlstring required

HTTPS URL endpoint where webhook events will be delivered

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

Webhook created 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