LeoYeAI/agent-master-skills / skills/alchemy-official
alchemy-official
Verifiedreferences/webhooks-details.md
View on GitHub---
id: references/webhooks-details.md
name: 'Webhooks Overview (Notify)'
description: 'Notify webhooks push blockchain events to your server so you don''t need to poll. They are ideal for near real-time pipelines.'
tags:
- alchemy
- webhooks
- webhook
related:
- webhooks-webhook-types.md
- webhooks-verify-signatures.md
- webhooks-address-activity.md
updated: 2026-02-05
---
# Webhooks Overview (Notify)
## Summary
Notify webhooks push blockchain events to your server so you don't need to poll. They are ideal for near real-time pipelines.
## Primary Use Cases
- Activity feeds and notifications.
- Indexer triggers for downstream processing.
- Security monitoring for wallet activity.
## When To Use / Not Use
- Use when you need low-latency updates.
- Avoid if you only need periodic snapshots.
## How It Works
1. Create a webhook (dashboard or API).
2. Configure filters (addresses, contract, event types).
3. Receive POST payloads in your webhook endpoint.
4. Verify the signature and process idempotently.
## Auth Token (Dashboard)
- The Notify API uses an **auth token** for managing webhooks.
- You must generate this token in the Alchemy dashboard.
- Placeholder format for examples: `ALCHEMY_NOTIFY_AUTH_TOKEN=<GENERATE_IN_DASHBOARD>`
## Notify API Endpoints (Spec-Derived)
- Base URL: `https://dashboard.alchemy.com/api`
- Required header for API management calls: `X-Alchemy-Token: <ALCHEMY_NOTIFY_AUTH_TOKEN>`
Common endpoints:
- `POST /create-webhook`
- `PUT /update-webhook`
- `PATCH /update-webhook-addresses`
- `PATCH /update-webhook-nft-filters`
- `GET /team-webhooks`
- `GET /webhook-addresses?webhook_id=...`
- `GET /webhook-nft-filters?webhook_id=...`
- `DELETE /delete-webhook?webhook_id=...`
## Spec-Derived Create Payload
`POST /create-webhook` requires:
- `network` (enum, e.g., `ETH_MAINNET`, `BASE_MAINNET`, `ARB_MAINNET`)
- `webhook_type` (enum: `GRAPHQL`, `ADDRESS_ACTIVITY`, `NFT_ACTIVITY`)
- `webhook_url`
Optional fields:
- `name`
- `addresses[]` (required for `ADDRESS_ACTIVITY`)
- `nft_filters[]` (required for `NFT_ACTIVITY`)
- `graphql_query` (required for `GRAPHQL`; string or `{ query, skip_empty_messages? }`)
## Operational Guidance
- Store webhook IDs for future updates or deletion.
- Implement retries and idempotency using event IDs.
- Persist raw payloads for audit/debugging.
## Related Files
- `webhooks-webhook-types.md`
- `webhooks-verify-signatures.md`
- `webhooks-address-activity.md`
## Official Docs
- [Notify API Quickstart](https://www.alchemy.com/docs/reference/notify-api-quickstart)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |