> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onboard.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks for Stablecoin Transactions

Full payload schemas are in [WebHook Events](/api-reference/webhook-events).

| Event                                         | Fires when                                                                                                |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `account_activity.crypto_beneficiary.created` | A crypto beneficiary is added                                                                             |
| `account_activity.crypto_beneficiary.deleted` | A crypto beneficiary is deleted                                                                           |
| `transaction_activity.crypto_deposit.*`       | A crypto deposit is detected, confirmed, or completed (`.created`, `.updated`, `.completed`, `.failed`)   |
| `transaction_activity.crypto_withdrawal.*`    | A crypto withdrawal is created, broadcast, or completed (`.created`, `.updated`, `.completed`, `.failed`) |

### Sample payloads

Full field-by-field schemas for every event are in
[WebHook Events](/api-reference/webhook-events#transaction-activity-samples).
Both crypto event families share the `AccountTransaction` shape for
`activityData`; only `direction`, `activityType`, and `type` differ.

<AccordionGroup>
  <Accordion title="account_activity.crypto_beneficiary.created">
    ```json theme={null}
    {
      "event": "account_activity.crypto_beneficiary.created",
      "data": {
        "id": "e2a1c4b8-3d5f-4a2e-9b1c-7f8e6d5c4b3a",
        "address": "0x7BCc5bCBa19DE3C903F062D8fB5fF8d9f818173E",
        "network": "BASE",
        "name": "Treasury wallet"
      },
      "timestamp": 1784711523
    }
    ```
  </Accordion>

  <Accordion title="transaction_activity.crypto_deposit.completed">
    ```json theme={null}
    {
      "event": "transaction_activity.crypto_deposit.completed",
      "data": {
        "id": "8e6d5c4b-3a7f-4a2e-9b1c-2e1a4c8b5d3f",
        "activityType": "CryptoDepositActivity",
        "type": "CRYPTO_DEPOSIT",
        "direction": "CREDIT",
        "amount": 150.00,
        "currency": "USD",
        "status": "SUCCESS",
        "accountId": "d9e9f9c1-6a3b-4b2e-8b3a-2f1e4d5c6b7a",
        "accountType": "SUB_ACCOUNT",
        "subAccountId": "6f9d3a2e-1b5c-4e88-9a2f-3c7d5e9b1a04",
        "activityAt": "2026-07-24T10:00:05.000Z",
        "activityData": {
          "id": "txn_9f41b3e6c2a",
          "reference": "REF9F41B3E6C2A",
          "type": "DEPOSIT",
          "amount": 150.00,
          "currency": "USD",
          "status": "SUCCESS",
          "categoryTag": "crypto-deposit",
          "notes": "Deposit of USDC on BASE",
          "createdDate": "2026-07-24T10:00:00.000Z"
        }
      },
      "timestamp": 1784887205
    }
    ```
  </Accordion>

  <Accordion title="transaction_activity.crypto_withdrawal.completed">
    ```json theme={null}
    {
      "event": "transaction_activity.crypto_withdrawal.completed",
      "data": {
        "id": "8e6d5c4b-3a7f-4a2e-9b1c-2e1a4c8b5d3f",
        "activityType": "CryptoWithdrawalActivity",
        "type": "CRYPTO_WITHDRAWAL",
        "direction": "DEBIT",
        "amount": 150.00,
        "currency": "USD",
        "status": "SUCCESS",
        "accountId": "d9e9f9c1-6a3b-4b2e-8b3a-2f1e4d5c6b7a",
        "accountType": "SUB_ACCOUNT",
        "subAccountId": "6f9d3a2e-1b5c-4e88-9a2f-3c7d5e9b1a04",
        "activityAt": "2026-07-24T10:00:05.000Z",
        "activityData": {
          "id": "txn_9f41b3e6c2a",
          "reference": "REF9F41B3E6C2A",
          "type": "WITHDRAWAL",
          "amount": -150.00,
          "currency": "USD",
          "status": "SUCCESS",
          "categoryTag": "crypto-withdrawal",
          "notes": "Withdrawal to USDC on BASE",
          "createdDate": "2026-07-24T10:00:00.000Z"
        }
      },
      "timestamp": 1784887205
    }
    ```
  </Accordion>
</AccordionGroup>