Bridge now supports webhook events for the following categories:
  • customer
  • kyc_link
  • liquidation_address.drain
  • static_memo.activity
  • transfer
  • virtual_account.activity
Additional event categories will be added soon.

💬 Feedback welcome — Let us know which event types you’d like to see prioritized next.

Supported Event Types

CategorySupported Event Types
customercreated, updated, updated.status_transitioned, deleted
kyc_linkcreated, updated, updated.status_transitioned
liquidation_address.draincreated, updated, updated.status_transitioned
static_memo.activitycreated, updated
transfercreated, updated, updated.status_transitioned
virtual_account.activitycreated, updated

Event Object Schema

Each webhook payload includes:
FieldDescription
api_versionCurrent version of Bridge APIs (v0).
event_idGlobally unique event identifier. Useful as an idempotency key.
event_categoryCategory of the event (e.g., virtual_account.activity).
event_typeFormatted as <event_category>.<mutation_type>.
event_object_idSame value as event_object.id (duplicated for easy access).
event_object_statusOptional. Populated when the object has a concept of status (e.g., kyc_status, transfer_status).
event_objectThe full resource data, matching the structure in Bridge’s API reference.
event_object_changesDiffs from the previous event (only present on updates).
event_created_atTimestamp of the event in ISO 8601 format.

Supported Mutation Types

Each event can have the following mutation types:
  • created
  • updated
  • updated.status_transitioned (for state transitions like KYC or Transfer status)
  • deleted (if applicable)

Examples

Below is a creation event for a Virtual Account Activity event object
{
  "api_version": "v0",
  "event_id": "wh_t8TAhPPYrRV2v8Asi9ed3sw",
  "event_developer_id": "371983-uery-1238-1238971",
  "event_category": "virtual_account.activity",
  "event_type": "virtual_account.activity.created",
  "event_object_id": "fecffc8b-ed5e-48ae-bd24-b36268330b32",
  "event_object_status": null,
  "event_object": {
    "id": "fecffc8b-ed5e-48ae-bd24-b36268330b32",
    "type": "payment_submitted",
    "amount": "1970.0",
    "source": {
      "description": "EXAMPLE TRANSACTION Brown-Beer Arnoldo Schimmel MD 01202024",
      "sender_name": "Brown-Beer",
      "payment_rail": "ach_push",
      "sender_bank_routing_number": "023883013"
    },
    "gas_fee": "0.0",
    "currency": "usdc",
    "created_at": "2024-02-01T04:31:43.342Z",
    "deposit_id": "c7fab38f-7b65-42d3-bc8d-a694cd1901c1",
    "customer_id": "6ed47d9c-03be-420c-8699-369707ca02e9",
    "subtotal_amount": "1970.0",
    "virtual_account_id": "22033ca5-a991-476c-ade9-911d10f0ece6",
    "exchange_fee_amount": "10.0",
    "developer_fee_amount": "20.0"
  },
  "event_object_changes": {
  },
  "event_created_at": "2024-02-01T04:32:28.978Z"
}
{
  "api_version": "v0",
  "event_id": "wh_t8trBtrPEqeFYLrQD9Zjog4",
  "event_category": "virtual_account.activity",
  "event_type": "virtual_account.activity.updated",
  "event_object_id": "fecffc8b-ed5e-48ae-bd24-b36268330b32",
  "event_object_status": null,
  "event_object": {
    "id": "fecffc8b-ed5e-48ae-bd24-b36268330b32",
    "type": "payment_submitted",
    "amount": "1970.0",
    "source": {
      "description": "EXAMPLE TRANSACTION Brown-Beer Arnoldo Schimmel MD 01202024",
      "sender_name": "Brown-Beer",
      "payment_rail": "ach_push",
      "sender_bank_routing_number": "023883013"
    },
    "gas_fee": "0.0",
    "currency": "usdc",
    "created_at": "2024-02-01T04:31:43.342Z",
    "deposit_id": "c7fab38f-7b65-42d3-bc8d-a694cd1901c1",
    "customer_id": "6ed47d9c-03be-420c-8699-369707ca02e9",
    "subtotal_amount": "1970.0",
    "virtual_account_id": "22033ca5-a991-476c-ade9-911d10f0ece6",
    "destination_tx_hash": "0xa7de792daa970f89cdb36dbce93026d10942ea24",
    "exchange_fee_amount": "10.0",
    "developer_fee_amount": "20.0"
  },
  "event_object_changes": {
    "destination_tx_hash": [ null, "0xa7de792daa970f89cdb36dbce93026d10942ea24" ]
  },
  "event_created_at": "2024-02-01T04:34:13.763Z"
}