Scrapfly Webhooks

When to Use This Skill

• How do I receive Scrapfly webhooks?
• How do I verify Scrapfly webhook signatures?
• How do I handle async Scrape API, Extraction API, or Screenshot API results?
• How do I route Scrapfly webhooks by resource type (scrape, extraction, screenshot)?
• How do I handle Crawler API webhook events (crawler_started, crawler_finished, ...)?
• Why is my Scrapfly webhook signature verification failing?

Prerequisites

• A paid Scrapfly plan. Webhooks are not available on the FREE plan — its webhook queue size is 0, so no deliveries are ever dispatched even after configuration. The dashboard hides the webhook UI on the free tier. Any paid tier enables delivery. See references/setup.md for the full plan-detection checklist.

How Scrapfly Webhooks Work

Scrapfly uses HMAC-SHA256 with uppercase hex encoding over the raw request body. There is no SDK for webhook verification — implementations follow Scrapfly's documented algorithm.