TriggerNetlifyReal-timeUpdated May 2026
When does Netlify fire on deploy start?
Short answer: Drop the "Netlify → Netlify Deploy Building" 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.
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 Building
When the matching event happens
when a deploy starts buildingon deploy buildingwhen deploy buildingwatch for deploy buildingnew deploy building
What this trigger returns
for the curiousYou 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_building","state": "building","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_building" |
| state | string | "building" |
| branch | string | "main" |
Pairs with
Drop these actions after Netlify Deploy Building.
FAQ
Questions about Netlify Deploy Building.
How does the Netlify Deploy Building trigger work in Netlify?
Fires when a deploy enters the building state. For "deploy started → update status page, notify team" workflows.
Is the Netlify Deploy Building trigger real-time?
Yes. Netlify Deploy Building uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Netlify.
What data does Netlify Deploy Building 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 Building 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 Building?
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.
More triggers
Other Netlify triggers.
Trigger
Netlify Deploy Created
Fires when a new deploy is created (queued or building). For comprehensive deploy-history tracking workflows.
TriggerNetlify Deploy Failed
Fires when a deploy fails. For "post failure log + commit info to engineering Slack" or "alert if main branch deploy fails" critical-failure workflows.
TriggerNetlify Deploy Succeeded
Fires when a deploy goes live. For "post the deploy URL to Slack", "trigger downstream cache purge", "update status page back to operational" workflows.
TriggerNetlify Form Submission
Fires when a Netlify Form is submitted. For "static-site form → push to CRM" workflows where you don't want to run a backend just to handle form submissions.
Build a workflow on this trigger.
One trigger. 4+ downstream actions. Zero glue.
