These are the event values Blnk sends to your global webhook URL. Configure your endpoint in notification configuration , then handle the events listed below.
Ledgers Event name Description ledger.createdWhen a ledger is created.
Balances Event name Description balance.createdWhen a balance is created.
Balance monitors Event name Description balance.monitorWhen a balance monitor is triggered because its conditions are met.
Transactions Event name Description transaction.appliedWhen a transaction is applied or committed. transaction.inflightWhen a transaction is inflight. transaction.voidWhen an inflight transaction is voided. transaction.scheduledWhen a transaction is successfully scheduled. transaction.rejectedWhen a transaction is rejected.
Bulk transactions Event name Description bulk_transaction.appliedWhen all items in a bulk transaction have been applied. bulk_transaction.inflightWhen all items in a bulk transaction are successfully inflight. bulk_transaction.failedWhen a bulk transaction fails.
Identities Event name Description identity.createdWhen an identity is created.
Reconciliations Available in version 0.15.0 and later.
Event name Description reconciliation.completedWhen a reconciliation run completes successfully. reconciliation.failedWhen a reconciliation run fails.
Start reconciliation and Instant reconciliation return only reconciliation_id. Read status, match counts, and timestamps from the webhook payload.System errors Available in version 0.12.0 and later.
Event name Description system.errorWhen a system error occurs (e.g. duplicate reference).
{ "event" : "system.error" , "data" : { "error" : "reference 0x8fa3c1a2b7d9_q has already been used" , "time" : "2025-12-08T10:30:45Z" } }
Field Type Description errorString The error message describing what went wrong. timeString ISO 8601 formatted timestamp when the error occurred.
Global webhooks Configure your webhook URL and handle deliveries.
Webhooks overview Global vs transaction hooks and security.
Need help? We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.
To ask questions or discuss issues, please contact us or join our Discord community .
