Create webhook

POST

https://dashboard.alchemy.com/api/create-webhook

Creates a webhook. The JSON body takes network, webhook_type, webhook_url, and an optional name, plus the fields for the type: addresses for ADDRESS_ACTIVITY, nft_filters for NFT_ACTIVITY, and graphql_query for GRAPHQL.

Headers

stringrequired

Your team's auth token. Find it on the Webhooks page of the Alchemy dashboard.

Request Body

Responses

200

Created the webhook

400

Invalid input

401

Requires authentication

403

Active webhook limit reached

429

Rate limited

503

Webhooks service unavailable

POST/api/create-webhook

curl --request POST \  --url https://dashboard.alchemy.com/api/create-webhook \  --header 'Content-Type: application/json' \  --header 'X-Alchemy-Token: string' \  --data '{  "network": "ABSTRACT_MAINNET",  "webhook_type": "ADDRESS_ACTIVITY",  "webhook_url": "string",  "name": "string",  "app_id": "string",  "addresses": [    "string"  ],  "nft_filters": [    {      "contract_address": "string",      "token_id": "string"    }  ],  "graphql_query": "string"}'

{  "data": {    "id": "wh_octjglnywaupz6th",    "name": "Treasury wallet activity",    "network": "ETH_MAINNET",    "networks": [],    "webhook_type": "ADDRESS_ACTIVITY",    "webhook_url": "https://example.com/webhooks/alchemy",    "is_active": true,    "time_created": 1730764800000,    "signing_key": "whsec_7mXvC3qGkJ2pT9sLwR4nYbE8",    "version": "V2",    "deactivation_reason": "UNKNOWN"  }}

Was this page helpful?