replicate-webhooks

Automate Replicate webhook validation and event handling for Express, Next.js, and FastAPI.

79|11|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/hookdeck/webhook-skills --skill replicate-webhooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: replicate-webhooks
Source: https://github.com/hookdeck/webhook-skills/tree/main/skills/replicate-webhooks
Command: npx skills add https://github.com/hookdeck/webhook-skills --skill replicate-webhooks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the reception and verification of Replicate webhooks, enabling reliable, real-time prediction event handling without manual wiring.

Core Features & Use Cases

  • Secure webhook intake: validates signature and freshness to prevent replay attacks.
  • Multi-framework support: ready-to-use patterns for Express, Next.js, and FastAPI.
  • Event-aware processing: parses and logs status-driven payloads (start, processing, output, completed) to trigger downstream actions.

Quick Start

Install a webhook secret, deploy a simple endpoint, and start receiving signed webhook events from Replicate.

Frequently Asked Questions about replicate-webhooks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify Replicate webhook signatures in Next.js?

To verify Replicate webhook signatures in Next.js, you must handle the raw request body to compute the signature correctly. This process checks timestamp freshness and validates the payload to prevent replay attacks on your endpoint.

How do I handle Replicate prediction status events in an Express webhook endpoint?

Handling Replicate prediction status events in an Express webhook endpoint involves parsing payload statuses like start, processing, output, and completed. You can trigger downstream actions based on these status-driven events for real-time updates.

Can I use FastAPI to receive and validate Replicate webhooks?

Yes, you can use FastAPI to receive and validate Replicate webhooks. The framework supports raw body handling necessary for accurate signature verification, ensuring your prediction event processing remains secure and reliable.

Why does Replicate webhook signature verification fail without raw body handling?

Replicate webhook signature verification fails without raw body handling because modifying the request body alters its hash. You must maintain the original raw payload to accurately compute and validate the webhook signature against the incoming request.

What is the best way to prevent replay attacks on Replicate webhook endpoints?

The best way to prevent replay attacks on Replicate webhook endpoints is to enforce timestamp freshness checks during validation. This ensures that intercepted webhook payloads cannot be resent and processed after a specified time window.