HTTP Webhook # Wire DeployHQ Into Anything You Build Receive a signed HTTP POST whenever a deploy starts, succeeds, or fails. Build custom dashboards, light up status pages, ping your CRM — anything you can write code for. [Start Free Trial](/signup?cta=Start+Free+Trial) Signed payloads JSON body Free plan available Last updated on 8th May 2026 POST /deploys/incoming Status 200 OK Signature Verified Latency 84ms ## Off-The-Shelf Integrations Don't Cover Everything Your in-house dashboard, status page, or CRM doesn't have a Slack-style listing. So how does it know when you ship? DeployShips codeInternal dashboardCustom status pageCRM / customer commsAudit / compliance logCustom ToolsOut of syncCustom systems are blind to deployments No integration listing covers every tool you build internally — yet those are the ones that need deploy data the most. ## One Webhook, Any Endpoint DeployHQ POSTs a signed JSON payload to any URL you give it. Receive it on a Lambda, a Rails route, a Cloudflare Worker — wherever your code lives. DeployFinishesDeployHQSign payloadPOST to URLYour Endpoint200 OK ✓Anything happens nextSigned! ## How It Works Plug in a URL and a secret — that's the whole setup. 1 ![Link icon](/assets/icons/link-8a603022ae63ac39632fb80b724b15efe10ee196c06ce0af7d627654a5147eaa.svg) ### Build an Endpoint Write a route in your application that accepts POST requests and verifies the signature header against a shared secret. 2 ![Text icon](/assets/icons/text-4e556c28179c8aa2c87cbad966a3805f4b07a7d82b1a71b129247d19c3c6d5e0.svg) ### Add to DeployHQ Drop the URL and secret into your DeployHQ project's HTTP integration. Pick which deploy events should fire the webhook. 3 ![Check icon](/assets/icons/check-a44bf1dbe680e7b7d11c6ba4f27febd17fde07a1f0bab9f93608e0e1d9acee9b.svg) ### Process the Payload Verify the HMAC, parse the JSON, and do whatever your business logic needs — update a row, fan out to other systems, anything. ## Why Use HTTP Webhooks When the integration list doesn't cover your case, the HTTP webhook does. ![Zap icon](/assets/icons/zap-17eaa1be55c76d539c8ab6b4c667d86fc6478529af6fc62d282cf996beda3fe0.svg) ### Real-Time Delivery Each deploy event POSTs immediately. Your endpoint receives JSON within milliseconds of the event firing. ![Shield icon](/assets/icons/shield-check-a41a13fb7948321ec9c27cc6c623578153c9caa1fc75851bcd93afbe7dbe79f1.svg) ### Signed Payloads Every request includes an HMAC signature. Verify the body against your shared secret to be certain it's from DeployHQ. ![Text icon](/assets/icons/text-4e556c28179c8aa2c87cbad966a3805f4b07a7d82b1a71b129247d19c3c6d5e0.svg) ### Structured JSON Stable JSON schema with project, environment, status, revision, and timestamps. Sample payloads live in the docs for testing. ![Check icon](/assets/icons/check-a44bf1dbe680e7b7d11c6ba4f27febd17fde07a1f0bab9f93608e0e1d9acee9b.svg) ### Build Anything Update a custom dashboard, broadcast to customer-facing status pages, write to an audit log, kick off downstream workflows — your call. Getting Started ## Wire up your endpoint in minutes ![Check mark](/assets/icons/tick-01ba7f4740d492a18fbdf4424bf7446c87ddfccbc0157214ad536b11512e914d.svg) ### Build the Receiver Stand up a POST endpoint that reads the body, verifies the X-DeployHQ-Signature header, and returns 200 quickly. ![Check mark](/assets/icons/tick-01ba7f4740d492a18fbdf4424bf7446c87ddfccbc0157214ad536b11512e914d.svg) ### Configure DeployHQ Add an HTTP integration with your URL and a shared secret. Pick which events (start, success, failure) should fire it. ![Check mark](/assets/icons/tick-01ba7f4740d492a18fbdf4424bf7446c87ddfccbc0157214ad536b11512e914d.svg) ### Trigger and Confirm Run a deployment. Check your endpoint's logs to confirm the request landed, the signature verified, and your handler did its thing. [Read the documentation →](https://www.deployhq.com/support/integrations/http-post) HTTP WEBHOOK FLOWdeployProduction deployment finishedSuccessPOST signed JSON to your URLPOST /webhooks/deploy200 OK · 84ms✓✓ Signature verified, handler ran ## Frequently Asked Questions ### What does the HTTP integration send? DeployHQ POSTs a JSON payload containing the project, environment, deployment status (started, completed, or failed), revision, branch, timestamps, and a few related fields. The body is signed with HMAC using a shared secret so you can verify it really came from DeployHQ. A sample payload lives in the support docs. ### How do I verify the signature? Each request carries an X-DeployHQ-Signature header containing an HMAC-SHA256 of the raw request body, keyed by the secret you set when configuring the integration. Compute the HMAC of the body using the same secret on your side and compare — examples in Ruby, Python, Node, and PHP are in the docs. ### What happens if my endpoint is down? DeployHQ retries failed deliveries with exponential backoff. A deployment never blocks on a webhook — your release ships either way — but the integration logs failed deliveries so you can investigate or replay them when the receiver comes back online. ## Ready to wire deploys into your own systems? Stand up an HTTP webhook and let DeployHQ feed your custom dashboards, status pages, and internal tooling automatically. [Start Free Trial](/signup?cta=Start+Free+Trial) 10-day free trial • No setup fees • Cancel anytime ## Explore More Features Discover all the tools that make DeployHQ the easiest way to deploy your code. [ ### Zero Downtime Deployments →](/features/zero-downtime-deployments)[ ### One-Click Rollback →](/features/one-click-rollback)[ ### Turbo Deployments →](/features/turbo-deployments)[ ### Build Pipelines →](/features/build-pipelines)[ ### Build Cache →](/features/build-cache)[ ### Scheduled Deployments →](/features/scheduled-deployments)[ ### Deployment Availability →](/features/deployment-availability)[ ### Docker Builds →](/features/docker-builds)[ ### Deployment Checks →](/features/deployment-checks)[ ### Deployment Targets →](/features/deployment-targets)[ ### Automatic Deployment →](/features/automatic-deployments)[ ### Deployment Templates →](/features/deployment-templates)[ ### Deploy Behind Firewalls →](/features/deploy-behind-firewalls)[ ### SSH Deployment →](/features/ssh-deployment)[ ### Deployment Zones →](/features/deployment-zones)[ ### Team & Permissions →](/features/team-permissions)[ ### Single Sign-On →](/features/sso)[ ### Custom Actions →](/features/custom-actions)[ ### Server Management →](/features/server-management)[ ### CLI & Agents →](/agents)[ ### Powerful Integrations →](/features/integrations) ## Get started today for just $9/month That's unlimited deployments and 3 projects. [Start your free 10 day trial](/signup?cta=Start+your+free+10+day+trial)