LeoYeAI/agent-master-skills / skills/alchemy-official
alchemy-official
Verifiedreferences/webhooks-custom-webhooks.md
View on GitHub---
id: references/webhooks-custom-webhooks.md
name: 'Custom Webhooks (GraphQL)'
description: 'Custom webhooks allow flexible event filtering using a GraphQL query hosted by Alchemy.'
tags:
- alchemy
- webhooks
- webhook
related:
- webhooks-webhook-types.md
- webhooks-webhook-payloads.md
updated: 2026-02-05
---
# Custom Webhooks (GraphQL)
## Summary
Custom webhooks allow flexible event filtering using a GraphQL query hosted by Alchemy.
## Primary Use Cases
- Multi-contract event triggers.
- Custom event signatures or ABI decoding.
- Fine-grained filters by topics or addresses.
## Spec-Derived Create Fields
When `webhook_type=GRAPHQL`, `graphql_query` is required and can be:
- A string containing the GraphQL query, or
- An object with fields `query` (string, required) and `skip_empty_messages` (boolean, optional)
## Configuration Notes
- Use the smallest filter that meets your needs to reduce noise.
- Test filters on testnet before mainnet.
## Operational Guidance
- Maintain a versioned set of filters to simplify migrations.
## Related Files
- `webhooks-webhook-types.md`
- `webhooks-webhook-payloads.md`
## Official Docs
- [Custom Webhooks Guide](https://www.alchemy.com/docs/how-to-use-custom-webhooks-for-crypto-token-alerts)
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 |