TriggerNetlifyReal-timeUpdated June 2026

When does Netlify fire on deploy failures?

Short answer: Drop the "Netlify → Netlify Deploy Failed" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in Netlify, not on a polling schedule.

Use this trigger All 5 Netlify triggers

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder

Trigger

Netlify Deploy Failed

When the matching event happens

on deploy failedwhen a deploy fails on netlifynew deploy failedwhen deploy failedwatch for deploy failed

What this trigger returns

for the curious

You don’t need to read this. Tiny Command auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
  "id": "deploy_123",
  "event": "deploy_failed",
  "state": "error",
  "branch": "main"
}

Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

Field	Type	Example
id	string	"deploy_123"
event	string	"deploy_failed"
state	string	"error"
branch	string	"main"

Pairs with

Drop these actions after Netlify Deploy Failed.

Add Labels to Message

Gmail · Email

Add Reaction

Slack · Communication

Add Sheet Tab

Google Sheets · Spreadsheets & Databases

Create Company

HubSpot · CRM & Sales

FAQ

Questions about Netlify Deploy Failed.

How does the Netlify Deploy Failed trigger work in Netlify?

Fires when a deploy fails. For "post failure log + commit info to engineering Slack" or "alert if main branch deploy fails" critical-failure workflows.

Is the Netlify Deploy Failed trigger real-time?

Yes. Netlify Deploy Failed uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Netlify.

What data does Netlify Deploy Failed return?

The full event payload from Netlify. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.

Can I filter Netlify Deploy Failed so only some events start a workflow?

Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.

Do I need Netlify admin permissions to use Netlify Deploy Failed?

For most Netlify accounts a standard user can authorize the trigger. Some Netlify plans require an admin to enable third-party webhooks. Check Netlify's docs if the trigger fails to register.