Cfx Labs Webhooks

generated: '2026-10-08'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.cfx.to/docs/webhook-events.md
sources:
- https://docs.cfx.to/docs/webhook-events.md
- https://docs.cfx.to/docs/webhook-events
- https://docs.cfx.to/reference/post_v1-reward-event-config.md
- https://docs.cfx.to/reference/get_v1-reward-event-config.md
description: CFX Labs webhooks fire on lifecycle state changes of platform objects.
events:
- event: account.depositMemo.created
  description: A deposit memo has been created against a ledger account.
- event: account.depositMemo.deleted
  description: A deposit memo has been deleted.
- event: account.ledgerAccount.balanceUpdated
  description: A ledger account's balance has changed.
- event: account.ledgerAccount.created
  description: A ledger account has been opened.
- event: account.ledgerAccount.statusUpdated
  description: A ledger account has changed status.
- event: account.virtualAccount.created
  description: A virtual account has been requested.
- event: account.virtualAccount.statusUpdated
  description: A virtual account has changed status.
- event: card.cardTransaction.statusUpdated
  description: A card transaction has changed status.
- event: deposit.cashRequest.statusUpdated
  description: A cash deposit request has changed status.
- event: deposit.deposit.created
  description: A deposit has been created.
- event: deposit.deposit.statusUpdated
  description: A deposit has changed status.
- event: deposit.manualMint.created
  description: A manual mint has been created.
- event: deposit.manualMint.statusUpdated
  description: A manual mint has changed status.
- event: entity.document.deleted
  description: A document belonging to an identity or organization has been deleted.
- event: entity.document.uploaded
  description: A document has been uploaded for an identity or organization.
- event: escrow.escrowTransfer.statusUpdated
  description: An escrow transfer has changed status.
- event: identity.identity.statusUpdated
  description: An identity has changed status.
- event: deposit.cryptoRequest.statusUpdated
  description: The status of a crypto deposit quote has changed.
- event: identity.verification.statusUpdated
  description: The status of an identity verification process has changed.
- event: organization.organization.statusUpdated
  description: The status of an organization has changed.
- event: reward.reward.claimed
  description: The status of a reward claim has changed.
- event: reward.reward.created
  description: A reward has been created.
- event: swap.swap.statusUpdated
  description: The status of a swap between currencies has changed.
- event: withdrawal.withdrawal.statusUpdated
  description: The status of a withdrawal has changed.
- event: send.send.statusUpdated
  description: The status of a fund transfer has changed.
- event: user.register.statusUpdated
  description: The status of a CFX wallet has changed.
delivery:
  signature: All webhook requests are signed using the Standard Webhooks specification. Headers `webhook-id`, `webhook-timestamp`, and `webhook-signature`
    are included; the signature is a base64‑encoded HMAC‑SHA256 of `${webhook-id}.${webhook-timestamp}.${body}` using the signing secret `whsec_<base64>`.
  retries: At‑least‑once delivery with automatic retries on non‑2xx responses or timeouts, using exponential backoff (base 2) for up to 10 attempts.
    After 20 consecutive failures the destination is disabled.
docs: https://docs.cfx.to/docs/webhook-events.md