---
updatedAt: 2026-05-20T16:31:22.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 Verification Challenge

Endpoint that should respond to webhook verification. challenge

<Callout icon="💡" theme="default">
  ### **Compute Unit Value**: `10` (fixed)
</Callout>

## Allow-listed IPs

To enhance security and prevent DDoS attacks, allow-list the following IP addresses that will hit your Events Webhook endpoints:

* `35.245.225.131`
* `34.150.141.91`
* `34.85.141.205`

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "Webhook target API",
    "description": "A reference of a webhook target that can be used in conjunction with Blockdaemon Event Streaming. ",
    "contact": {
      "name": "Blockdaemon",
      "email": "info@blockdaemon.com",
      "url": "https://blockdaemon.com"
    },
    "x-logo": {
      "url": "https://storage.googleapis.com/blockdaemon-app-static-images/marketing/PNG/dark-logo.png",
      "altText": "Blockdaemon logo"
    }
  },
  "servers": [
    {
      "url": "https://svc.blockdaemon.com/streaming/v2"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    },
    {
      "apiKeyAuthHeader": []
    }
  ],
  "components": {
    "securitySchemes": {
      "apiKeyAuthHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "Unlock higher TPS - Create your own API key in the [Blockdaemon App](https://app.blockdaemon.com).\n",
        "x-default": "2go1YqUcuAr4WZ2-3WgSD3c7qpatZqQuNWhTVBldKZnTSUtw"
      },
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "Opaque",
        "description": "[Legacy Auth] Unlock higher TPS - Create your own API key in the [Blockdaemon App](https://app.blockdaemon.com).\n",
        "x-default": "2go1YqUcuAr4WZ2-3WgSD3c7qpatZqQuNWhTVBldKZnTSUtw"
      }
    },
    "schemas": {
      "WebhookVerificationResponse": {
        "type": "object",
        "properties": {
          "response_token": {
            "type": "string",
            "description": "the response token is a HMAC using SHA256. Where the webhook secret is the key, and the challenge token the payload.",
            "example": "sha256=da0g909egewoqijgq987gfqe98tgyee8t"
          }
        }
      }
    }
  },
  "paths": {
    "/": {
      "get": {
        "tags": [
          "webhook"
        ],
        "summary": "Webhook Verification Challenge",
        "description": "Endpoint that should respond to webhook verification. challenge",
        "operationId": "webhook verification challenge",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "The challenge token",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "323i523-058jo3h523uh5234"
          }
        ],
        "responses": {
          "200": {
            "description": "Response to webhook verfication request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookVerificationResponse"
                }
              }
            }
          }
        }
      }
    }
  }
}
```