Bridge Webhooks

generated: '2026-07-18'
method: searched
source:
- https://apidocs.bridge.xyz/get-started/introduction/quick-start/setting-up-webhooks
- openapi/bridge-openapi-original.json (WebhookEventCategory, WebhookEvent schemas)
spec_type: Webhooks
transport: https-post
docs: https://apidocs.bridge.xyz/get-started/introduction/quick-start/setting-up-webhooks
delivery:
  model: >
    Developers register webhook endpoints (POST /webhooks). Bridge POSTs signed
    event payloads to the endpoint URL. Endpoints can be listed, updated, deleted,
    disabled/reactivated, replayed (send-event), and inspected (upcoming events +
    delivery logs). Reactivating a disabled endpoint delivers only events from the
    reactivation point onward (no backlog replay, as of 2026-06-29).
  management_operations:
  - GET /webhooks
  - POST /webhooks
  - PUT /webhooks/{webhookID}
  - DELETE /webhooks/{webhookID}
  - GET /webhooks/{webhookID}/events
  - POST /webhooks/{webhookID}/send
  - GET /webhooks/{webhookID}/logs
  - GET /webhook_events
event_envelope:
  fields:
  - api_version
  - event_id
  - event_developer_id
  - event_sequence
  - event_category
  - event_type
  - event_object_id
  - event_object
  - event_object_changes
  - event_created_at
event_categories:
- customer
- kyc_link
- liquidation_address.drain
- static_memo.activity
- transfer
- virtual_account.activity
- bridge_wallet.activity
- card_account
- card_transaction
- card_withdrawal
- posted_card_account_transaction
- external_account
example_event_types:
- customer.created
- customer.updated
- transfer.created
- transfer.updated
- virtual_account.activity
- static_memo.activity
- bridge_wallet.activity
activity_sub_types:
  virtual_account:
  - funds_scheduled
  - funds_received
  - payment_submitted
  - payment_processed
  - in_review
  - refund
  - refund_in_flight
  - refund_failed
  - microdeposit
  - account_update
  - deactivation
  - activation
  static_memo:
  - funds_received
  - payment_submitted
  - payment_processed
  - in_review
  - refunded
  - refund_in_flight
  - refund_failed
  - account_update
notes: >
  Bridge documents a webhook event surface but does not publish an AsyncAPI
  document. This artifact captures the webhook catalog (type: Webhooks). No
  AsyncAPI spec was fabricated.