🚀 VaultsPay API v1 is live. See what's new →
WebhooksEvent Types

Event Types

Subscribe to only the events you care about when creating your endpoint.

Users

EventTriggered when
user.createdA user is created.
user.updatedAny field on the user is updated.
user.deletedUser is soft-deleted.
user.kyc.status_changedKYC status transitions (e.g. pending → approved).
user.kyc.document_uploadedA new identity document is uploaded.

Accounts

EventTriggered when
account.createdA new account is opened.
account.closedAn account is closed.
account.balance.updatedThe account’s available balance changed.
account.transfer.inboundMoney arrived via IBAN / SWIFT / internal.
account.transfer.outboundMoney left the account (outbound transfer).

Cards

EventTriggered when
card.createdA virtual card is issued.
card.activatedA physical card is activated.
card.frozenCard is frozen.
card.unfrozenCard is unfrozen.
card.terminatedCard is terminated.
card.shipping.dispatchedPhysical card leaves the personalisation bureau.
card.shipping.deliveredPhysical card delivered to the user.
card.pin_setUser has set or reset their PIN.
card.controls.updatedSpend controls / limits changed.
card.transaction.authorisedAuthorisation placed (funds reserved).
card.transaction.declinedAuthorisation declined. See decline_reason in payload.
card.transaction.postedSettlement posted (affects available balance).
card.transaction.refundedA refund was posted back to the card.
card.transaction.reversedAn authorisation was released without settlement.

System

EventTriggered when
pingSent on endpoint creation and from the dashboard.
endpoint.failedAn endpoint has failed delivery 10 times in a row.