Supported events

These are the event values Blnk sends to your global webhook URL. Configure your endpoint in webhook configuration, then handle the events listed below.

Ledgers

Event name	Description
`ledger.created`	When a ledger is created.

Balances

Event name	Description
`balance.created`	When a balance is created.

Balance monitors

Event name	Description
`balance.monitor`	When a balance monitor is triggered because its conditions are met.

Transactions

Event name	Description
`transaction.applied`	When a transaction is applied or committed.
`transaction.inflight`	When a transaction is inflight.
`transaction.void`	When an inflight transaction is voided.
`transaction.scheduled`	When a transaction is successfully scheduled.
`transaction.rejected`	When a transaction is rejected.

Bulk transactions

Event name	Description
`bulk_transaction.applied`	When all items in a bulk transaction have been applied.
`bulk_transaction.inflight`	When all items in a bulk transaction are successfully inflight.
`bulk_transaction.failed`	When a bulk transaction fails.

Identities

Event name	Description
`identity.created`	When an identity is created.

Metadata

Available in version 0.15.5 and later.

Event name	Description
`ledger.metadata.updated`	After a successful public ledger metadata update.
`balance.metadata.updated`	After a successful public balance metadata update.
`identity.metadata.updated`	After a successful public identity metadata update.
`transaction.metadata.updated`	After a successful public transaction metadata update.

Blnk sends these events only after a successful public Update metadata request. Internal metadata writes do not emit them. Each payload includes event_id and timestamp in data for deduplication. Ledger, balance, and identity — full resource snapshot with merged meta_data for this write (same shape as *.created events). Transaction — patch only:

Example payload

{
  "event": "transaction.metadata.updated",
  "data": {
    "transaction_id": "txn_c62f200b-905f-4983-a349-cadd279234aa",
    "meta_data_patch": {
      "settlement_batch": "B-42"
    },
    "event_id": "7f1b0c8d-4e55-4b19-9e2c-a1c83e2f4b19",
    "timestamp": "2026-09-24T12:50:59Z"
  }
}

Field	Type	Description
`transaction_id`	String	The id you passed (`txn_…` or `bulk_…`). For bulk ids, one event is sent but the merge applies to every matching row.
`meta_data_patch`	Object	The metadata this request applied. Blnk does not re-read merged `meta_data` in the event.
`event_id`	String	Unique id for this event.
`timestamp`	String	UTC time when the event was enqueued.

The metadata merge is authoritative once the API returns 200. Webhook delivery is best-effort after that. Update metadata to trigger these events.

Reconciliations

Available in version 0.15.0 and later.

Event name	Description
`reconciliation.completed`	When a reconciliation run completes successfully.
`reconciliation.failed`	When 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.error`	When a system error occurs (e.g. duplicate reference).

Example payload

{
  "event": "system.error",
  "data": {
    "error": "reference 0x8fa3c1a2b7d9_q has already been used",
    "time": "2025-12-08T10:30:45Z"
  }
}

Field	Type	Description
`error`	String	The error message describing what went wrong.
`time`	String	ISO 8601 formatted timestamp when the error occurred.

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.

Start Here

Ledgers

Ledger balances

Transactions

Reconciliation

Identities

Metadata

Search

Webhooks

API keys

Guides

Configuration

Advanced

Migration guides

Ledgers

Balances

Balance monitors

Transactions

Bulk transactions

Identities

Metadata

Reconciliations

System errors

Need help?

​Ledgers

​Balances

​Balance monitors

​Transactions

​Bulk transactions

​Identities

​Metadata

​Reconciliations

​System errors

​Need help?

Ledgers

Balances

Balance monitors

Transactions

Bulk transactions

Identities

Metadata

Reconciliations

System errors

Need help?