---
updatedAt: 2026-05-20T16:31:17.000Z
---

Fetch the complete documentation index at: https://docs.blockdaemon.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Webhook Debugging

### Debugging Status Failed

If your target fails the verification check, its status will be **"failed"**. You can debug the verification process using the `/target/:id/validate-verification` endpoint of the Config API.

**Request Payload**

Replace `<TARGET_ID>` with the webhook target ID you want to verify.

```curl
curl --location 'https://svc.blockdaemon.com/streaming/v2/targets/<TARGET_ID>/validate-verification' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data ' '
```

**Response Payload**

```json
{
    "duration": "8.99986ms",
    "error_response_message": "failed validation token is not as expected",
    "error_status_code": 200,
    "status": "failed"
}
```

The response includes the following information:

| Fields                   | Description                                                                                                                                                                                                                  |
| :----------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `status`                 | The target's status based on the verification executed with this request.                                                                                                                                                    |
| `error_response_code`    | The response code returned by the webhook during the verification request. In this case, it returns a 200 -  OK request.                                                                                                     |
| `error_response_message` | The details of what went wrong. In this example, the response token returned was invalid. This could be due to the secret used for the HMAC not matching the target's settings or the wrong payload used to create the HMAC. |

### Debugging Processing Issues

To debug issues related to message processing, you can use the `validate-message` endpoint to send mock messages to your webhook. This allows you to simulate the messages your service will receive during operation.

**Request Payload**

Replace `<TARGET_ID>` with the webhook target ID you want to verify.

```curl
curl --location 'https://svc.blockdaemon.com/streaming/v2/targets/<TARGET_ID>/validate-message' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer token' \
--data '{
    "protocol": "bitcoin",
    "type": "confirmed_tx",
    "template":"UNIFIED_V1"
}'
```

**Response Payload**

```json
{
    "duration": "23.100988ms",
    "status": "success"
}
```

Below is the example message that will be sent to the webhook target ID you specify in the request.

```json
{
    "protocol": "bitcoin",
    "network": "mainnet",
    "event_type": "unified_confirmed_tx",
    "data": {
        "block_number": 831386,
        "block_hash": "0000000000000000000157bdde026859b310ba79f905f1514f022d1dd6129a00",
        "tx_id": "77d80eb55bc1e99db7617c5b508452306e7049a54e7ec398a25a293339077763",
        "tx_hash": "8dc10b4e32f1d0900e8786cd81875190533c2dc4310a360116409e26a700f19e",
        "timestamp": 1233321795,
        "status": "success",
        "transfers": [
            {
                "asset": "native",
                "from": "bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h",
                "value": 22349655,
                "event_name": "vin"
            },
            {
                "asset": "native",
                "from": "bc1qu3aazsa92k2ws4mu5yzym0gwvdxvdqjmznmjgz",
                "value": 582900,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h",
                "value": 4215594,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qmwjjeestzkl260sf0zaxcylrjh3krjxmcatst7",
                "value": 1376000,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qpm3ptrup3lme3dqj30zq3sy54mxuwgta8r5f99",
                "value": 174060,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qagfwr2yl47ja4gmcu8yqqwx7cppmspdh3tjjaj",
                "value": 589630,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qgzyta95e4tjkks900j3nzydp732ya6r8z4quv3",
                "value": 7680000,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qzvkgdx0uma7dkcu4uull5sufm2lnmqf4dgyylf",
                "value": 407180,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qp6qe3c7sgr9tzx6vjpjjln9hnanlsmxduazgwl",
                "value": 374100,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1pf687nsnhxkynfzs2yt0ertedpjnj6enuqgufyc8qfymcgl8fzn5qdxvg0y",
                "value": 980000,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qlv7kt6x44xp3xqsyx9896mr68sfs6zvq9ctq70",
                "value": 1939139,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "3GWcpDTJshR9jq9uBufz3ka42pZHgZKe6v",
                "value": 1080000,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qxrzs7r49zhg6nhpxntzl0u4en2svksw4ynfp8h",
                "value": 497411,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qzxcunle4hems53uehszlq84fn5cm6ejekd7f0e",
                "value": 2288371,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qjc0cejltt57te78akwsc5ckuz250czp20r8y52",
                "value": 77420,
                "event_name": "vout"
            },
            {
                "asset": "native",
                "from": "bc1qe8l0s5ktdhpnys388xtt5vd0em8j38h7ktse4q",
                "value": 60000,
                "event_name": "vout"
            }
        ],
        "fee": {
            "asset":"native",
            "value": 27850
        }
    }
}
```

## 👋 Need Help?

Contact us through [email](mailto:support@blockdaemon.com) or our [support page](https://www.blockdaemon.com/support) for any issues, bugs, or assistance you may need.