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

# Webhook event types and data types

> Comprehensive list of webhook event types in WaaS 2.0, detailing each event's purpose and data structure.

<Tip>
  Try [Cobo WaaS Skill](/v2/guides/overview/cobo-waas-skill) in your AI coding assistant (Claude Code, Cursor, etc.). Describe your needs in natural language to auto-generate production-ready SDK code and debug faster 🚀
</Tip>

## Webhook event types

<Info>Here, transaction refers to all types of transactions, including deposits, withdrawals, contract calls, and message signing.</Info>

### Payment events

For payment webhook events, please refer to [Order Status and Events](/v2/payments/status-and-events).

### Transaction events (deposits/withdrawals/contract calls/message signing)

<Note>The following events apply to all types of transactions, including deposits, withdrawals, contract calls, and message signing.</Note>

<table class="table-three-cols">
  <thead>
    <tr>
      <th>Event Type</th>
      <th>Event Data Type</th>
      <th>When It Occurs</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>wallets.transaction.created</code></td>
      <td><code>Transaction</code></td>
      <td>A transaction has been detected on the blockchain, generating a transaction record. This event does not indicate that the transaction was successful.</td>
    </tr>

    <tr>
      <td><code>wallets.transaction.updated</code></td>
      <td><code>Transaction</code></td>
      <td>There are changes to a transaction's status or confirmation numbers.<Note>The <code>wallets.transaction.updated</code> event covers the entire lifecycle of a transaction, including creation, completion, and failure. If you want to track every status change, you need only subscribe to this event.</Note></td>
    </tr>

    <tr>
      <td><code>wallets.transaction.succeeded</code></td>
      <td><code>Transaction</code></td>
      <td>A transaction has been successfully completed.</td>
    </tr>

    <tr>
      <td><code>wallets.transaction.failed</code></td>
      <td><code>Transaction</code></td>
      <td>A transaction failed.</td>
    </tr>

    <tr>
      <td><code>token.suspended.deposit</code></td>
      <td><code>SuspendedToken</code></td>
      <td>A token deposit has been suspended.</td>
    </tr>

    <tr>
      <td><code>token.suspended.withdraw</code></td>
      <td><code>SuspendedToken</code></td>
      <td>A token withdrawal has been suspended.</td>
    </tr>
  </tbody>
</table>

### Fee Station events

<table class="table-three-cols">
  <thead>
    <tr>
      <th>Event Type</th>
      <th>Event Data Type</th>
      <th>When It Occurs</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>fee\_station.transaction.created</code></td>
      <td><code>Transaction</code></td>
      <td>A Fee Station transaction has been created.</td>
    </tr>

    <tr>
      <td><code>fee\_station.transaction.updated</code></td>
      <td><code>Transaction</code></td>
      <td>There are changes to the status of a Fee Station transaction.</td>
    </tr>

    <tr>
      <td><code>fee\_station.transaction.failed</code></td>
      <td><code>Transaction</code></td>
      <td>A Fee Station transaction failed.</td>
    </tr>

    <tr>
      <td><code>fee\_station.transaction.succeeded</code></td>
      <td><code>Transaction</code></td>
      <td>A Fee Station transaction has been successfully completed.</td>
    </tr>
  </tbody>
</table>

### MPC TSS request events

<table class="table-three-cols">
  <thead>
    <tr>
      <th>Event Type</th>
      <th>Event Data Type</th>
      <th>When It Occurs</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>wallets.mpc.tss\_request.created</code></td>
      <td><code>TSSRequest</code></td>
      <td>A TSS request is created.</td>
    </tr>

    <tr>
      <td><code>wallets.mpc.tss\_request.updated</code></td>
      <td><code>TSSRequest</code></td>
      <td>There are changes to the status of a TSS request.</td>
    </tr>

    <tr>
      <td><code>wallets.mpc.tss\_request.succeeded</code></td>
      <td><code>TSSRequest</code></td>
      <td>The requested action has been successfully completed.</td>
    </tr>

    <tr>
      <td><code>wallets.mpc.tss\_request.failed</code></td>
      <td><code>TSSRequest</code></td>
      <td>The requested action failed.</td>
    </tr>
  </tbody>
</table>

### Wallet and address management events

<table class="table-three-cols">
  <thead>
    <tr>
      <th>Event Type</th>
      <th>Event Data Type</th>
      <th>When It Occurs</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>wallets.addresses.created</code></td>
      <td><code>Addresses</code></td>
      <td>A new wallet address has been created.</td>
    </tr>

    <tr>
      <td><code>wallets.created</code></td>
      <td><code>WalletInfo</code></td>
      <td>A new wallet has been created.</td>
    </tr>

    <tr>
      <td><code>mpc\_vaults.created</code></td>
      <td><code>MPCVault</code></td>
      <td>A new MPC vault has been created.</td>
    </tr>
  </tbody>
</table>

### Token and chain management events

<table class="table-three-cols">
  <thead>
    <tr>
      <th>Event Type</th>
      <th>Event Data Type</th>
      <th>When It Occurs</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>wallet.token.enabled</code></td>
      <td><code>Tokens</code></td>
      <td>One or more tokens have been enabled.</td>
    </tr>

    <tr>
      <td><code>wallet.token.disabled</code></td>
      <td><code>Tokens</code></td>
      <td>One or more tokens have been disabled.</td>
    </tr>

    <tr>
      <td><code>wallet.chain.enabled</code></td>
      <td><code>Chains</code></td>
      <td>One or more chains have been enabled.</td>
    </tr>

    <tr>
      <td><code>wallet.chain.disabled</code></td>
      <td><code>Chains</code></td>
      <td>One or more chains have been disabled.</td>
    </tr>

    <tr>
      <td><code>wallets.token\_listing.failed</code></td>
      <td><code>TokenListing</code></td>
      <td>A token listing request failed.</td>
    </tr>

    <tr>
      <td><code>wallets.token\_listing.succeeded</code></td>
      <td><code>TokenListing</code></td>
      <td>A token listing request has been successfully processed and the token is now available.</td>
    </tr>
  </tbody>
</table>

### Balance update events

<table class="table-three-cols">
  <thead>
    <tr>
      <th>Event Type</th>
      <th>Event Data Type</th>
      <th>When It Occurs</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>wallet.mpc.balance.updated</code></td>
      <td><code>BalanceUpdateInfo</code></td>
      <td>The balance of an MPC Wallet has been updated.</td>
    </tr>

    <tr>
      <td><code>wallet.web3.balance.updated</code></td>
      <td><code>BalanceUpdateInfo</code></td>
      <td>The balance of a Custodial Wallet (Web3 Wallet) has been updated.</td>
    </tr>
  </tbody>
</table>

### Compliance events

<table class="table-three-cols">
  <thead>
    <tr>
      <th>Event Type</th>
      <th>Event Data Type</th>
      <th>When It Occurs</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>compliance.disposition.status.updated</code></td>
      <td><code>ComplianceDisposition</code></td>
      <td>There are changes to the status of a compliance disposition.</td>
    </tr>

    <tr>
      <td><code>compliance.kyt.screenings.status.updated</code></td>
      <td><code>ComplianceKytScreenings</code></td>
      <td>There are changes to the status of a KYT screening case.</td>
    </tr>
  </tbody>
</table>

## Data structure of webhook events

For a complete introduction of the webhook event data and its data structure, refer to the [data](/v2/api-references/developers--webhooks/retrieve-event-information#response-data) property in the response of the Retrieve event information operation or the [data.data](/v2/api-references/developers--webhooks/list-all-webhook-events#response-data-data) property in the response of the List all webhook event operation.

<img src="https://mintcdn.com/cobo-docs/jI6Qi6XMVoZeeN6L/v2/images/guides/webhook_data_structure.png?fit=max&auto=format&n=jI6Qi6XMVoZeeN6L&q=85&s=25f0b10d3c17b3f44daba0daa215179c" class="screenshot_full_screen" alt="Screenshot of the data property" width="2816" height="1557" data-path="v2/images/guides/webhook_data_structure.png" />

Switch between the event data types to view the data structure of each event data type.

Additionally, you can view all webhook events in your organization on **Cobo Portal** > **Developer**> **Webhook Events**.