---
title: "Receives Webhook Messages"
method: POST
path: "/"
tags: ["webhook"]
---

# Receives Webhook Messages

`POST /`

Endpoint that receives webhook messages after passing verification.

## Headers

- `x-bd-webhooks-signature` string, required

## Request body

- union
  - WebhookMessageUnifiedBlockRequest
    - `protocol` string, required
    - `network` string, required
    - `chain_id` string, required
    - `event_type` 'unified_block' | 'unified_confirmed_tx' | 'unified_confirmed_balance' | 'unified_confirmed_tx_log' | 'unified_reorg' | 'unified_staking_reward' | 'unified_staking_status' | 'system.connection' | 'system.dropped.messages', required
    - `data` WebhookMessageUnifiedBlockData, required
      - `block_number` integer, required
      - `block_hash` string, required
      - `parent_hash` string, required
      - `block_timestamp` integer, required
  - WebhookMessageUnifiedConfirmedBalanceRequest
    - `protocol` string, required
    - `network` string, required
    - `chain_id` string, required
    - `event_type` 'unified_block' | 'unified_confirmed_tx' | 'unified_confirmed_balance' | 'unified_confirmed_tx_log' | 'unified_reorg' | 'unified_staking_reward' | 'unified_staking_status' | 'system.connection' | 'system.dropped.messages', required
    - `data` WebhookMessageUnifiedConfirmedBalanceData, required
      - `block_number` integer, required
      - `block_hash` string, required
      - `block_timestamp` integer, required
      - `address` string, required
      - `asset` string, required
      - `value` integer
  - WebhookMessageUnifiedConfirmedTxRequest
    - `protocol` string, required
    - `network` string, required
    - `chain_id` string, required
    - `event_type` 'unified_block' | 'unified_confirmed_tx' | 'unified_confirmed_balance' | 'unified_confirmed_tx_log' | 'unified_reorg' | 'unified_staking_reward' | 'unified_staking_status' | 'system.connection' | 'system.dropped.messages', required
    - `data` WebhookMessageUnifiedConfirmedTxData, required
      - `block_number` integer, required
      - `block_hash` string, required
      - `tx_id` string, required
      - `tx_hash` string
      - `timestamp` integer, required
      - `status` string, required
      - `transfers` Transfer[]
        - `asset` string
        - `from` string
        - `to` string
        - `event_name` string
        - `value` integer
      - `fee` union
        - Transfer
          - `asset` string
          - `from` string
          - `to` string
          - `event_name` string
          - `value` integer
        - TransactionEvmFee
          - `gas_used` integer
          - `gas_price` integer
          - `gas_limit` integer
          - `value` integer
          - `max_fee_per_gas` integer
          - `max_priority_fee_per_gas` integer
  - WebhookMessageUnifiedConfirmedTxLogRequest
    - `protocol` string, required
    - `network` string, required
    - `chain_id` string, required
    - `event_type` 'unified_block' | 'unified_confirmed_tx' | 'unified_confirmed_balance' | 'unified_confirmed_tx_log' | 'unified_reorg' | 'unified_staking_reward' | 'unified_staking_status' | 'system.connection' | 'system.dropped.messages', required
    - `data` WebhookMessageUnifiedConfirmedTxLogData, required
      - `block_number` integer, required
      - `block_hash` string, required
      - `tx_id` string, required
      - `tx_hash` string
      - `timestamp` integer, required
      - `status` string, required
      - `transfers` Transfer[]
        - `asset` string
        - `from` string
        - `to` string
        - `event_name` string
        - `value` integer
  - WebhookMessageUnifiedReorgRequest
    - `protocol` string, required
    - `network` string, required
    - `chain_id` string, required
    - `event_type` 'unified_block' | 'unified_confirmed_tx' | 'unified_confirmed_balance' | 'unified_confirmed_tx_log' | 'unified_reorg' | 'unified_staking_reward' | 'unified_staking_status' | 'system.connection' | 'system.dropped.messages', required
    - `data` WebhookMessageUnifiedReorgData, required
      - `block_number` integer, required
      - `block_hash` string, required
      - `block_timestamp` integer, required
  - WebhookMessageUnifiedStakingRewardRequest
    - `protocol` string, required
    - `network` string, required
    - `chain_id` string, required
    - `event_type` 'unified_block' | 'unified_confirmed_tx' | 'unified_confirmed_balance' | 'unified_confirmed_tx_log' | 'unified_reorg' | 'unified_staking_reward' | 'unified_staking_status' | 'system.connection' | 'system.dropped.messages', required
    - `data` WebhookMessageUnifiedStakingRewardData, required
      - `address` string, required
      - `start_balance` integer, required
      - `return` integer, required
      - `start_time` integer
      - `end_time` integer
      - `period` string
      - `metadata` object
  - WebhookMessageUnifiedStakingStatusRequest
    - `protocol` string, required
    - `network` string, required
    - `chain_id` string, required
    - `event_type` 'unified_block' | 'unified_confirmed_tx' | 'unified_confirmed_balance' | 'unified_confirmed_tx_log' | 'unified_reorg' | 'unified_staking_reward' | 'unified_staking_status' | 'system.connection' | 'system.dropped.messages', required
    - `data` WebhookMessageUnifiedStakingStatusData, required
      - `address` string, required
      - `status` string, required
      - `timestamp` integer, required
      - `metadata` object
  - WebhookMessageSystemConnectionRequest
    - `protocol` string, required
    - `event_type` 'unified_block' | 'unified_confirmed_tx' | 'unified_confirmed_balance' | 'unified_confirmed_tx_log' | 'unified_reorg' | 'unified_staking_reward' | 'unified_staking_status' | 'system.connection' | 'system.dropped.messages', required
    - `data` WebhookMessageSystemConnectionData, required
      - `target_id` string
      - `disconnect_time` integer
      - `connection_time` integer
      - `previous_status` string
      - `new_status` string
  - WebhookMessageSystemDroppedMessagesRequest
    - `protocol` string, required
    - `event_type` 'unified_block' | 'unified_confirmed_tx' | 'unified_confirmed_balance' | 'unified_confirmed_tx_log' | 'unified_reorg' | 'unified_staking_reward' | 'unified_staking_status' | 'system.connection' | 'system.dropped.messages', required
    - `data` WebhookMessageSystemDroppedMessagesData, required
      - `target_id` string
      - `pending_msg_count` integer
      - `dropped_msg_count` integer
      - `time` string

## Response `200`

Response to webhook receive

## Other responses

- `400` — Bad request

---

[API](https://skmtc.dev/blockdaemon/apis/staking-api.md) · [All operations](https://skmtc.dev/blockdaemon/apis/staking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blockdaemon/staking-api/revisions/f94e296a08a3/schema)