Customers

Customers capability changed

Triggered when the customers.capability.changed webhook event is emitted. Your API will receive a POST request at the webhook URL you configured.

postWebhookcustomersCapabilityChanged

Payload

eventIdstring uuid required

Unique identifier for this logical webhook event. Webhooks are delivered at least once, so your endpoint may receive duplicate deliveries for the same event. Use this eventId as the idempotency/deduplication key.

eventType'customers.capability.changed' required

The type of webhook event.

timestampstring date-time required

The UTC ISO 8601 timestamp at which the underlying state change occurred, not the time at which this webhook was delivered.

Example payload

{
  "eventId": "3a7f8b2e-1c4d-4e9a-b5f6-d8a2c0e7f194",
  "eventType": "customers.capability.changed",
  "timestamp": "2026-04-01T12:00:02Z",
  "data": {
    "customerId": "customer_38d54acb-0868-431c-a88e-1ffcb62655eb",
    "capabilities": [
      {
        "code": "custodyFiat",
        "status": "active"
      }
    ]
  }
}

Response

Webhook received and processed successfully.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.