---
updatedAt: 2026-08-03T16:16:02.000Z
agentTools:
  projectIndex: https://docs.zerohash.com/llms.txt
---

# Connect

Programmatically monitor Connect activity with event-driven webhook notifications

# Overview

Connect delivers real-time webhook notifications when deposit and withdrawal events occur. These webhooks are sent to Organization-configured endpoint URLs and provide status updates throughout the lifecycle of each transaction.

There are two webhook payload types:

* `connect_deposit.status_changed` - fired when a deposit transitions to a new status
* `connect_withdrawal.status_changed` - fired when a withdrawal transitions to a new status

# Authentication and Delivery

* Webhooks are delivered via HTTP POST to the URLs configured in your Organization settings (separate URLs for deposits and withdrawals).
* Requests are authenticated using Organization-specific KMS-managed credentials.
* Failed deliveries are retried with exponential backoff.
* Each webhook has a unique event ID used for idempotency - you may safely deduplicate on this ID.

# Webhook Security

## Request Headers

| Header                 | Description                                                        |
| :--------------------- | :----------------------------------------------------------------- |
| client-id              | Always Connect.                                                    |
| timestamp              | Unix timestamp (seconds) when the request was signed.              |
| signature              | Base64-encoded RSA-SHA256 signature of the request.                |
| x-zh-hook-payload-type | The webhook payload type (e.g., connect\_deposit.status\_changed). |

## Validating the signature

1. Retrieve Connect's public keys from the JWKS endpoint (GET /v1/jwks).
2. Reconstruct the signing base string by concatenating: {timestamp}POST{webhook_url}{request_body}
   1. timestamp: the value from the timestamp header
   2. POST: the HTTP method (always POST)
   3. webhook\_url: the full URL of your webhook endpoint
   4. request\_body: the raw JSON request body
3. Base64-decode the signature header value.
4. Verify the decoded signature against the signing base using the RSA public key with PKCS1 v1.5 SHA-256.

# Deposit Webhooks

**Payload type:** connect\_deposit.status\_changed

> **Fee data for deposits with conversion**
>
> If your platform uses **Deposit (with conversion)**, fee details are **not** included in this webhook. They are delivered through the [Account Funding Transaction Update webhook](https://docs.zerohash.com/reference/fund-transaction-update#complete-example) instead (`deposit_fee_bps`, `deposit_fee_notional`, `deposit_fee_type`, `raw_fee_bps`, `raw_fee_notional`). The `fees` object described below only appears on Connect deposit webhooks for deposits **without conversion**.

## Deposit event names

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Event Name
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        connect.deposits.pending
      </td>

      <td>
        The end user clicked Submit on the Connect SDK, Connect has created a transaction within our system, and we are preparing to initiate the transaction within the connected-accounts' (ie, Coinbase) system
      </td>
    </tr>

    <tr>
      <td>
        connect.deposits.submitted
      </td>

      <td>
        The deposit has been created within the connected-accounts' (ie, Robinhood) system
      </td>
    </tr>

    <tr>
      <td>
        connect.deposits.confirmed
      </td>

      <td>
        The deposit has been confirmed on-chain
      </td>
    </tr>

    <tr>
      <td>
        connect.deposits.unexpected
      </td>

      <td>
        Connect received a deposit that was outside of the normal Auth flow. See full guide here.

        Only relevant if you are configured to prevent non-auth deposits
      </td>
    </tr>

    <tr>
      <td>
        connect.deposits.abandoned
      </td>

      <td>
        The end user started the deposit flow, but no deposit was received within 30 minutes
      </td>
    </tr>

    <tr>
      <td>
        connect.deposits.failed
      </td>

      <td>
        When Connect attempted to initiate the transaction with the connected-account, the connected-account failed the API call.
      </td>
    </tr>
  </tbody>
</Table>

**Note:** If you receive a `connect.deposits.submitted` webhook, followed by an `connect.deposits.abandoned` one, it means that either the connected-account had an issue processing the transaction **or** the blockchain itself had an issue processing the transaction. In either case, the user's balance at the connected-account should be re-credited.

## Deposit Payload Fields

### Top-level fields:

| Field   | Type   | Description                                     |
| :------ | :----- | :---------------------------------------------- |
| event   | string | The event name (ie, connect.deposits.confirmed) |
| deposit | object | Deposit details (see below)                     |
| session | object | Session details (see below)                     |
| account | object | Account details (see below)                     |

### `deposit` Object

| Field           | Type   | Always in payload? | Always has a value?         | Description                                                                                      |
| :-------------- | :----- | :----------------- | :-------------------------- | :----------------------------------------------------------------------------------------------- |
| id              | string | Yes                | Yes                         | Unique identifier for the deposit                                                                |
| amount          | string | Yes                | Yes                         | Deposit amount (ie, .13 BTC)                                                                     |
| network         | string | Yes                | Yes                         | Blockchain network (ie, ethereum)                                                                |
| asset           | string | Yes                | Yes                         | Asset (ie, USD, BTC, or ETH)                                                                     |
| created\_at     | string | Yes                | Yes                         | Timestamp when the deposit was created (ISO 8601).                                               |
| updated\_at     | string | Yes                | Yes                         | Timestamp when the deposit was last updated (ISO 8601).                                          |
| status          | string | No                 | When present, yes           | Current status value.                                                                            |
| transaction     | object | Yes                | Yes (but inner fields vary) | On-chain transaction details (see below).                                                        |
| source          | object | No                 | When present, yes           | Source of the deposit (see below). Present when the deposit originates from a known integration. |
| failure\_reason | string | No                 | When present, yes           | Reason for failure. Only present when the deposit has failed.                                    |
| account\_label  | string | No                 | When present, yes           | Label of the account associated with the withdrawal.                                             |
| fees            | object | No                 | When present, yes           | Fees associated with the deposit (see below). Only present for deposits **without conversion**.  |

### `deposit.transaction` object

| Field         | Type   | Always in payload? | Always has a value?                             | Description                                         |
| :------------ | :----- | :----------------- | :---------------------------------------------- | :-------------------------------------------------- |
| hash          | string | Yes                | No - empty string until transaction is on-chain | Blockchain transaction hash.                        |
| to            | string | No                 | When present, yes                               | Destination address on-chain                        |
| block\_number | string | No                 | When present, yes                               | Block number in which the transaction was included. |
| value         | string | No                 | When present, yes                               | Raw on-chain value of the transaction.              |

### `deposit.source` object (when present)

| Field       | Type   | Description                                            |
| :---------- | :----- | :----------------------------------------------------- |
| type        | string | Source type: `CUSTODIAL`, `NON_CUSTODIAL`, or `MANUAL` |
| integration | string | Integration identifier (ie, `robinhood`, `gemini`etc)  |

### `deposit.fees` object (when present)

Present on deposit webhooks for deposits **without conversion**, starting at the `connect.deposits.pending`/`connect.deposits.submitted` events. Deposits with conversion do not include this object — see the note at the top of this section.

| Field                      | Type   | Description                                                                                                                           |
| :------------------------- | :----- | :------------------------------------------------------------------------------------------------------------------------------------ |
| deposit                    | object | The fee charged on the deposit.                                                                                                       |
| deposit.amount             | string | \[Deprecated] Fee amount in either USD or crypto depending on type, now broken out into separate  crypto and notional fields.         |
| deposit.asset              | string | \[Deprecated] Fee asset. Always `USD` - the deposit fee is a fiat notional, now broken out into separate  crypto and notional fields. |
| deposit.crypto\_amount     | string | Fee amount in the crypto network asset denomination e.g. ETH for Ethereum gas fees                                                    |
| deposit.crypto\_asset      | string | Asset denomination of the crypto\_amount associated with the network                                                                  |
| deposit.notional\_amount   | string | Fee amount in notional currency                                                                                                       |
| deposit.notional\_currency | string | Notional currency, always `USD`                                                                                                       |

### `session` object

| Field       | Type   | Description                                                 |
| :---------- | :----- | :---------------------------------------------------------- |
| id          | string | Session identifier                                          |
| metadata    | object | Key-value metadata attached to the session at creation time |
| created\_at | string | Timestamp when the session was created (ISO 8601)           |

### `account` object

| Field         | Type   | Description                                                             |
| :------------ | :----- | :---------------------------------------------------------------------- |
| reference\_id | string | Your external reference ID for the account (ie, the `participant_code`) |

## Example Deposit Payloads

### Example Deposit Payload - `connect.deposits.pending`

```json
  {
    "event": "connect.deposits.pending",
    "deposit": {
        "id": "d1a2b3c4-5678-90ab-cdef-1234567890ab",
        "amount": "0.05",
        "network": "ethereum",
        "asset": "ETH",
        "created_at": "2026-03-29T14:00:00Z",
        "updated_at": "2026-03-29T14:00:00Z",
        "status": "pending",
        "transaction": {
            "hash": ""
        },
        "source": {
            "type": "CUSTODIAL",
            "integration": "robinhood"
        },
        "account_label": "abc123",
        "fees": {
            "deposit": {
                "amount": "0",
                "asset": "USD",
                "crypto_amount": "0",
                "crypto_asset": "ETH",
                "notional_amount": "0",
                "notional_currency": "USD"
            }
        }
    },
    "session": {
        "id": "a1b2c3d4-0000-0000-0000-000000000001",
        "metadata": {
            "user_id": "usr_12345",
            "order_id": "ord_67890"
        },
        "created_at": "2026-03-29T13:55:00Z"
    },
    "account": {
        "reference_id": "CUST01"
    }
}
```

### Example Deposit Payload - `connect.deposits.submitted`

```json
  {  
    "event": "connect.deposits.submitted",  
    "deposit": {  
      "id": "d1a2b3c4-5678-90ab-cdef-1234567890ab",  
      "amount": "0.05",  
      "network": "ethereum",  
      "asset": "ETH",  
      "created_at": "2026-03-29T14:00:00Z",  
      "updated_at": "2026-03-29T14:02:00Z",  
      "status": "submitted",  
      "transaction": {  
        "hash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890"  
      },  
      "source": {  
        "type": "CUSTODIAL",  
        "integration": "robinhood"  
      },  
      "account_label": "abc123",  
      "fees": {  
				"deposit": {
          "amount": "0",
          "asset": "USD",
          "crypto_amount": "0",
          "crypto_asset": "ETH",
          "notional_amount": "0",
          "notional_currency": "USD"
      }
      }  
    },  
    "session": {  
      "id": "a1b2c3d4-0000-0000-0000-000000000001",  
      "metadata": {  
        "user_id": "usr_12345",  
        "order_id": "ord_67890"  
      },  
      "created_at": "2026-03-29T13:55:00Z"  
    },  
    "account": {  
      "reference_id": "CUST01"  
    }  
  }
```

### Example Deposit Payload - `connect.deposits.confirmed`

```json
  {
    "event": "connect.deposits.confirmed",
    "deposit": {
        "id": "d1a2b3c4-5678-90ab-cdef-1234567890ab",
        "amount": "0.05",
        "network": "ethereum",
        "asset": "ETH",
        "created_at": "2026-03-29T14:00:00Z",
        "updated_at": "2026-03-29T14:15:00Z",
        "status": "confirmed",
        "transaction": {
            "hash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
            "to": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD68",
            "block_number": "19234567",
            "value": "50000000000000000"
        },
        "source": {
            "type": "CUSTODIAL",
            "integration": "robinhood"
        },
        "account_label": "abc123",
        "fees": {
            "deposit": {
                "amount": "0",
                "asset": "USD",
                "crypto_amount": "0",
                "crypto_asset": "ETH",
                "notional_amount": "0",
                "notional_currency": "USD"
            }
        }
    },
    "session": {
        "id": "a1b2c3d4-0000-0000-0000-000000000001",
        "metadata": {
            "user_id": "usr_12345",
            "order_id": "ord_67890"
        },
        "created_at": "2026-03-29T13:55:00Z"
    },
    "account": {
        "reference_id": "CUST01"
    }
}
```

### Example Deposit Payload - `connect.unexpected.failed`

```json
  {  
    "event": "connect.deposits.unexpected",  
    "deposit": {  
      "id": "d7a6b5c4-3210-98fe-badc-765432109edc",  
      "amount": "0.75",  
      "network": "ethereum",  
      "asset": "USDT",  
      "created_at": "2026-03-29T16:00:00Z",  
      "updated_at": "2026-03-29T16:00:00Z",  
      "status": "unexpected",  
      "transaction": {  
        "hash": "0x7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b",  
        "to": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD68",  
        "value": "750000000000000000"  
      }  
    },  
    "session": {  
      "id": "d4e5f6a7-0000-0000-0000-000000000004",  
      "metadata": {},  
      "created_at": "2026-03-29T15:50:00Z"  
    },  
    "account": {  
      "reference_id": "CUST01"  
    }  
  }
```

### Example Deposit Payload - `connect.deposits.failed`

```json
{  
    "event": "connect.deposits.failed",  
    "deposit": {  
      "id": "d9f8e7d6-5432-10fe-dcba-0987654321ab",  
      "amount": "1.00",  
      "network": "bitcoin",  
      "asset": "BTC",  
      "created_at": "2026-03-29T10:00:00Z",  
      "updated_at": "2026-03-29T10:30:00Z",  
      "status": "failed",  
      "transaction": {  
        "hash": "3a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b"  
      },  
      "failure_reason": "Transaction reverted on-chain",  
      "account_label": "primary"  
    },  
    "session": {  
      "id": "b2c3d4e5-0000-0000-0000-000000000002",  
      "metadata": {},  
      "created_at": "2026-03-29T09:55:00Z"  
    },  
    "account": {  
      "reference_id": "customer-67890"  
    }  
  }
```

### Example Deposit Payload - `connect.abandoned.failed`

```json
  {  
    "event": "connect.deposits.abandoned",  
    "deposit": {  
      "id": "d8e7f6a5-4321-09fe-cbad-876543210fed",  
      "amount": "2.00",  
      "network": "ethereum",  
      "asset": "ETH",  
      "created_at": "2026-03-29T08:00:00Z",  
      "updated_at": "2026-03-29T09:00:00Z",  
      "status": "abandoned",  
      "transaction": {  
        "hash": ""  
      },  
      "source": {  
        "type": "CUSTODIAL",  
        "integration": "robinhood"  
      },  
      "account_label": "abc123"  
    },  
    "session": {  
      "id": "c3d4e5f6-0000-0000000-000000000003",  
      "metadata": {  
        "user_id": "usr_55555"  
      },  
      "created_at": "2026-03-29T07:55:00Z"  
    },  
    "account": {  
      "reference_id": "CUST01"  
    }  
  }
```

# Withdrawal Webhooks

**Payload type:** connect\_withdrawal.status\_changed

## Withdrawal event names

| Event Name                    | Description                                                             |
| :---------------------------- | :---------------------------------------------------------------------- |
| connect.withdrawals.pending   | Withdrawal has been created and is queued for processing.               |
| connect.withdrawals.submitted | Withdrawal has been submitted to the blockchain network for processing. |
| connect.withdrawals.confirmed | Withdrawal has been confirmed on-chain and completed successfully.      |
| connect.withdrawals.failed    | Withdrawal failed during processing.                                    |

## Withdrawal Payload Fields

### Top-level fields:

| Field      | Type   | Description                                         |
| :--------- | :----- | :-------------------------------------------------- |
| event      | string | The event name (ie, connect.withdrawals.confirmed). |
| withdrawal | object | Withdrawal details (see below).                     |
| session    | object | Session details (same structure as deposits).       |
| account    | object | Account details (same structure as deposits).       |

### `withdrawal` object

| Field          | Type   | Always in payload?          | Description                                                                                     |
| :------------- | :----- | :-------------------------- | :---------------------------------------------------------------------------------------------- |
| id             | string | Yes                         | Unique identifier for the withdrawal.                                                           |
| amount         | string | Yes                         | Withdrawal amount.                                                                              |
| network        | string | Yes                         | Blockchain network (ie, ethereum, bitcoin).                                                     |
| asset          | string | Yes                         | Asset identifier (ie, ETH, BTC).                                                                |
| created\_at    | string | Yes                         | Timestamp when the withdrawal was created (ISO 8601).                                           |
| updated\_at    | string | Yes                         | Timestamp when the withdrawal was last updated (ISO 8601).                                      |
| status         | string | When present, yes           | Current status value. Omitted when empty.                                                       |
| transaction    | object | Yes (but inner fields vary) | On-chain transaction details (see below).                                                       |
| destination    | object | When present, yes           | Destination of the withdrawal. Only present when the withdrawal is sent to a known integration. |
| account\_label | string | When present, yes           | Label of the account associated with the withdrawal.                                            |
| fees           | object | When present, yes           | Fees associated with the withdrawal (see below). Timing depends on the fee payment model.       |

### `withdrawal.transaction` object

| Field         | Type   | Always in payload? | Always has a value?                             | Description                                                                               |
| :------------ | :----- | :----------------- | :---------------------------------------------- | :---------------------------------------------------------------------------------------- |
| hash          | string | Yes                | No - empty string until transaction is on-chain | Blockchain transaction hash.                                                              |
| to            | string | No                 | When present, yes                               | Destination wallet address. Omitted when not known.                                       |
| block\_number | string | No                 | When present, yes                               | Block number in which the transaction was included. Only present once confirmed on-chain. |
| value         | string | No                 | When present, yes                               | Raw on-chain value of the transaction. Only present once confirmed on-chain.              |

### `withdrawal.destination` object (when present):

| Field       | Type   | Description                                                              |
| :---------- | :----- | :----------------------------------------------------------------------- |
| type        | string | Destination type: `CUSTODIAL`, `NON_CUSTODIAL`, or `MANUAL`.             |
| integration | string | Integration identifier:  `robinhood`,`gemini`, `metamask`, `manual`, etc |

### `withdrawal.fees` object (when present)

| Field                         | Type        | Description                                                                                                                                  |
| :---------------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------- |
| network                       | object      | The network (blockchain gas) fee. Omitted if there is no network fee.                                                                        |
| network.amount                | string      | \[Deprecated] Network fee amount in USD or crypto depending on type, now broken out into separate crypto and notional fields.                |
| network.asset                 | string      | \[Deprecated] Network fee asset. Omitted when `fee_payment_model` is `ADDITIVE`, now broken out into separate crypto and notional fields.    |
| network.crypto\_amount        | string      | Network fee in crypto denomination, e.g. amount in ETH for Ethereum gas fees                                                                 |
| network.crypto\_asset         | string      | Network fee in asset denomination e.g. ETH for Ethereum                                                                                      |
| network.notional\_amount      | string      | Network Fee amount in notional currency                                                                                                      |
| network.notional\_currency    | string      | Network fee in notional currency, always `USD`                                                                                               |
| withdrawal                    | object      | The withdrawal (spread) fee. Omitted if there is no withdrawal fee.                                                                          |
| withdrawal.amount             | string      | \[Deprecated] Withdrawal fee amount in USD or crypto depending on type, now broken out into separate crypto and notional fields.             |
| withdrawal.asset              | string      | \[Deprecated] Withdrawal fee asset. Omitted when `fee_payment_model` is `ADDITIVE`, now broken out into separate crypto and notional fields. |
| withdrawal.crypto\_amount     | string      | Withdrawal fee in crypto denomination, e.g. amount in ETH for Ethereum gas fees                                                              |
| withdrawal.crypto\_asset      | string      | Withdrawal fee in asset denomination e.g. ETH for Ethereum                                                                                   |
| withdrawal.notional\_amount   | string      | Withdrawal Fee amount in notional currency                                                                                                   |
| withdrawal.notional\_currency | string      | Withdrawal fee in notional currency, always `USD`                                                                                            |
| fee\_payment\_model           | string enum | `ADDITIVE` or `NETTED`. Describes how fees were charged relative to the withdrawal amount.                                                   |

**Fee payment models:**

* `NETTED` — the fee is netted out of the withdrawal, and the fee `asset` fields are populated. `fees` is present starting at `connect.withdrawals.submitted`.
* `ADDITIVE` — the fee is charged additively, and the fee `asset` fields are omitted from `network` and `withdrawal`. `fees` is only present once `connect.withdrawals.confirmed`.

The `fees` object is omitted entirely if no fee amounts and no `fee_payment_model` are present.

## Example Withdrawal Payloads

### `connect.withdrawals.pending`

```json
  {  
    "event": "connect.withdrawals.pending",  
    "withdrawal": {  
      "id": "w1a2b3c4-5678-90ab-cdef-fedcba098765",  
      "amount": "0.10",  
      "network": "ethereum",  
      "asset": "ETH",  
      "created_at": "2026-03-29T16:00:00Z",  
      "updated_at": "2026-03-29T16:00:00Z",  
      "status": "pending",  
      "transaction": {  
        "hash": "",  
        "to": "0x1234567890abcdef1234567890abcdef12345678"  
      },  
      "destination": {  
        "type": "CUSTODIAL",  
        "integration": "robinhood"  
      },  
      "account_label": "abc123"  
    },  
    "session": {  
      "id": "f6a7b8c9-0000-0000-0000-000000000006",  
      "metadata": {  
        "user_id": "usr_12345"  
      },  
      "created_at": "2026-03-29T15:50:00Z"  
    },  
    "account": {  
      "reference_id": "CUST01"  
    }  
  }
```

### `connect.withdrawals.submitted`

```json
  {  
    "event": "connect.withdrawals.submitted",  
    "withdrawal": {  
      "id": "w1a2b3c4-5678-90ab-cdef-fedcba098765",  
      "amount": "0.10",  
      "network": "ethereum",  
      "asset": "ETH",  
      "created_at": "2026-03-29T16:00:00Z",  
      "updated_at": "2026-03-29T16:00:00Z",  
      "status": "pending",  
      "transaction": {  
        "hash": "",  
        "to": "0x1234567890abcdef1234567890abcdef12345678"  
      },  
      "destination": {  
        "type": "CUSTODIAL",  
        "integration": "robinhood"  
      },  
      "account_label": "abc123"  
    },  
    "session": {  
      "id": "f6a7b8c9-0000-0000-0000-000000000006",  
      "metadata": {  
        "user_id": "usr_12345"  
      },  
      "created_at": "2026-03-29T15:50:00Z"  
    },  
    "account": {  
      "reference_id": "CUST01"  
    }  
  }
```

### `connect.withdrawals.submitted` — `NETTED` fee model (fees already present)

```json
  {
    "event": "connect.withdrawals.submitted",
    "withdrawal": {
        "id": "w1a2b3c4-5678-90ab-cdef-fedcba098765",
        "amount": "0.10",
        "network": "ethereum",
        "asset": "ETH",
        "created_at": "2026-03-29T16:00:00Z",
        "updated_at": "2026-03-29T16:01:00Z",
        "status": "submitted",
        "transaction": {
            "hash": "",
            "to": "0x1234567890abcdef1234567890abcdef12345678"
        },
        "destination": {
            "type": "CUSTODIAL",
            "integration": "robinhood"
        },
        "account_label": "abc123",
        "fees": {
            "network": {
                "amount": "0.379211",
                "asset": "USDC",
                "crypto_amount": "0.379211",
                "crypto_asset": "USDC",
                "notional_amount": "0.38",
                "notional_currency": "USD"
            },
            "withdrawal": {
                "amount": "0",
                "asset": "USDC",
                "crypto_amount": "0",
                "crypto_asset": "USDC",
                "notional_amount": "0",
                "notional_currency": "USD"
            },
            "fee_payment_model": "NETTED"
        }
    },
    "session": {
        "id": "f6a7b8c9-0000-0000-0000-000000000006",
        "metadata": {
            "user_id": "usr_12345"
        },
        "created_at": "2026-03-29T15:50:00Z"
    },
    "account": {
        "reference_id": "CUST01"
    }
}
```

### `connect.withdrawals.submitted` — `ADDITIVE` fee model (fees not yet present)

For `ADDITIVE` withdrawals, `fees` is omitted until the withdrawal reaches `connect.withdrawals.confirmed`.

```json
  {  
    "event": "connect.withdrawals.submitted",  
    "withdrawal": {  
      "id": "w1a2b3c4-5678-90ab-cdef-fedcba098765",  
      "amount": "0.10",  
      "network": "ethereum",  
      "asset": "ETH",  
      "created_at": "2026-03-29T16:00:00Z",  
      "updated_at": "2026-03-29T16:01:00Z",  
      "status": "submitted",  
      "transaction": {  
        "hash": "",  
        "to": "0x1234567890abcdef1234567890abcdef12345678"  
      },  
      "destination": {  
        "type": "CUSTODIAL",  
        "integration": "robinhood"  
      },  
      "account_label": "abc123"  
    },  
    "session": {  
      "id": "f6a7b8c9-0000-0000-0000-000000000006",  
      "metadata": {  
        "user_id": "usr_12345"  
      },  
      "created_at": "2026-03-29T15:50:00Z"  
    },  
    "account": {  
      "reference_id": "CUST01"  
    }  
  }
```

### `connect.withdrawals.confirmed` — `NETTED` fee model

```json
  {
    "event": "connect.withdrawals.confirmed",
    "withdrawal": {
        "id": "w1a2b3c4-5678-90ab-cdef-fedcba098765",
        "amount": "0.10",
        "network": "ethereum",
        "asset": "ETH",
        "created_at": "2026-03-29T16:00:00Z",
        "updated_at": "2026-03-29T16:20:00Z",
        "status": "confirmed",
        "transaction": {
            "hash": "0xdef789abc123456def789abc123456def789abc123456def789abc123456def78",
            "to": "0x1234567890abcdef1234567890abcdef12345678"
        },
        "destination": {
            "type": "CUSTODIAL",
            "integration": "robinhood"
        },
        "account_label": "abc123",
        "fees": {
            "network": {
                "amount": "0.379211",
                "asset": "USDC",
                "crypto_amount": "0.379211",
                "crypto_asset": "USDC",
                "notional_amount": "0.38",
                "notional_currency": "USD"
            },
            "withdrawal": {
                "amount": "0",
                "asset": "USDC",
                "crypto_amount": "0",
                "crypto_asset": "USDC",
                "notional_amount": "0",
                "notional_currency": "USD"
            },
            "fee_payment_model": "NETTED"
        }
    },
    "session": {
        "id": "f6a7b8c9-0000-0000-0000-000000000006",
        "metadata": {
            "user_id": "usr_12345"
        },
        "created_at": "2026-03-29T15:50:00Z"
    },
    "account": {
        "reference_id": "CUST01"
    }
}
```

### `connect.withdrawals.confirmed` — `ADDITIVE` fee model

```json
  {  
    "event": "connect.withdrawals.confirmed",  
    "withdrawal": {  
      "id": "w1a2b3c4-5678-90ab-cdef-fedcba098765",  
      "amount": "0.10",  
      "network": "ethereum",  
      "asset": "ETH",  
      "created_at": "2026-03-29T16:00:00Z",  
      "updated_at": "2026-03-29T16:20:00Z",  
      "status": "confirmed",  
      "transaction": {  
        "hash": "0xdef789abc123456def789abc123456def789abc123456def789abc123456def78",  
        "to": "0x1234567890abcdef1234567890abcdef12345678"  
      },  
      "destination": {  
        "type": "CUSTODIAL",  
        "integration": "robinhood"  
      },  
      "account_label": "abc123",  
      "fees": {  
        "network": {  
          "amount": "0.42"  
        },  
        "withdrawal": {  
          "amount": "1.00"  
        },  
        "fee_payment_model": "ADDITIVE"  
      }  
    },  
    "session": {  
      "id": "f6a7b8c9-0000-0000-0000-000000000006",  
      "metadata": {  
        "user_id": "usr_12345"  
      },  
      "created_at": "2026-03-29T15:50:00Z"  
    },  
    "account": {  
      "reference_id": "CUST01"  
    }  
  }
```

### `connect.withdrawals.failed`

```json
  {  
    "event": "connect.withdrawals.failed",  
    "withdrawal": {  
      "id": "w9z8y7x6-5432-10fe-dcba-0987654321ab",  
      "amount": "500.00",  
      "network": "bitcoin",  
      "asset": "BTC",  
      "created_at": "2026-03-29T12:00:00Z",  
      "updated_at": "2026-03-29T12:15:00Z",  
      "status": "failed",  
      "transaction": {  
        "hash": "",  
        "to": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"  
      },  
      "destination": {  
        "type": "NON_CUSTODIAL",  
        "integration": "metamask"  
      },  
      "account_label": "def456"  
    },  
    "session": {  
      "id": "a7b8c9d0-0000-0000-0000-000000000007",  
      "metadata": {},  
      "created_at": "2026-03-29T11:55:00Z"  
    },  
    "account": {  
      "reference_id": "CUST01"  
    }  
  }
```