Webhook Receiver

Why deploy Webhook Receiver on Render?

Webhook Receiver is a server application that listens for and processes incoming webhook HTTP requests. It solves the problem of capturing event notifications from external services (like Render's deployment events) and acting on them programmatically, such as logging payloads or fetching related data from APIs.

This template gives you a production-ready webhook receiver with the service already configured to accept Render webhook payloads and fetch additional context from the Render API. Instead of manually setting up a Node.js service, configuring the webhook endpoint path, and wiring up the API integration yourself, you get a working foundation with one click. The template is pre-wired to handle Render-specific webhook events and enrich them with service, Postgres, or Key Value store details—just add your API key and webhook secret to start capturing deploy events, health checks, and more.

Architecture

What you can build

After deploying, you'll have a webhook receiver endpoint that listens for Render platform events and logs the payloads, automatically enriching certain events with additional context from the Render API. This gives you a working starting point for building automations triggered by deploys, service changes, or other activity in your Render account.

Key features

• Webhook payload logging: Receives incoming webhooks and logs the complete payload for debugging and monitoring purposes.
• Render API integration: Automatically fetches additional context from Render API for services, Postgres databases, or Key Value stores based on webhook event types.
• Webhook signature verification: Uses RENDER_WEBHOOK_SECRET environment variable to validate incoming webhook authenticity.
• One-click Render deployment: Includes render.yaml blueprint configuration for instant deployment via Deploy to Render button.

Use cases

• DevOps engineer tracks deployment events and logs service status changes automatically
• Platform team builds Slack alerts when database or service deploys fail
• Developer syncs Render deployment events to external monitoring dashboard
• SRE creates audit trail of all infrastructure changes across services

Prerequisites

• Render API Key: An API key used to authenticate requests to the Render API for fetching service, Postgres, or Key Value store information.
• Render Webhook Secret: The secret token used to verify that incoming webhook requests are genuinely from Render.

Next steps

1. Configure a new webhook in Render Dashboard pointing to your service URL with /webhook path — You should see the webhook listed in your Render Dashboard under Webhook settings with an active status
2. Trigger a test deploy on any Render service in your account — You should see the webhook payload logged in your webhook receiver service logs within seconds, showing event details like service ID and deploy status
3. Open your service logs and verify the RENDER_API_KEY is working — You should see enriched webhook data including fetched service, Postgres, or Key Value store details alongside the raw webhook payload