Reference · Tools
Netlify Trigger
Starts workflow when Netlify deploy or form submission events occur via webhooks
The Netlify Trigger fires when Netlify reports a deploy lifecycle event or a form submission on the site you select. A typical build is alerting a channel when a production deploy fails, or routing contact-form submissions straight into a CRM.
- Node type
- Webhook trigger
- Parameters
- 4
- Outputs
- Output
- Credentials
- Netlify
Netlify Trigger
Triggers on Netlify deploy events and form submissions
Overview
Receives webhook notifications from Netlify when deploy lifecycle events or form submissions occur. Supports deploy_created, deploy_building, deploy_failed, and submission_created events. The trigger registers a notification hook on the specified Netlify site via the Netlify API, which sends POST requests to the webhook URL when the selected event fires. For form submissions, you can optionally scope to a specific form or listen to all forms. The Simplify option for form submissions returns only the form field data instead of the full payload. Useful for CI/CD automation, deploy status notifications, deployment failure alerts, and capturing form submissions from Netlify-hosted sites.
Category: Development
Tool Name: netlify_trigger
Version: 1
Appearance: Icon: si-netlify | Color: #00c7b7
Node Type
Trigger — webhook (receives incoming HTTP callbacks)
Input / Output
| Direction | Port(s) |
|---|---|
| Input | None (trigger node) |
| Output | Output |
Credentials
This tool requires Netlify credentials. See the Credentials Guide for setup instructions.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| Site | string | Yes | — | The Netlify Site ID to monitor for events. Find this in your Netlify site settings under General > Site details. |
| Event | options | Yes | — | The Netlify event type to listen for. |
Options: deployBuilding, deployCreated, deployFailed, submissionCreated (Form Submitted) | ||||
| Form | string | Yes | * | The Netlify form ID to listen for submissions on. Use ”*” for all forms, or enter a specific form ID. (shown when Event is submissionCreated) |
| Simplify | boolean | No | true | Whether to return a simplified version of the response instead of the raw data. When enabled, only the form field data is returned. (shown when Event is submissionCreated) |
Output Data
Each Netlify notification produces one output item:
_trigger— alwaysnetlify_webhook_timestamp— ISO 8601 timestamp of when the request arrived_webhookEvent— the Netlify event name:deploy_building,deploy_created,deploy_failedorsubmission_created
The Netlify payload is merged in at the top level, so deploy notifications expose the deploy’s own fields (id, site, state, branch, URLs, timestamps) directly on the item. For form submissions with Simplify turned on, only the submission’s form-field data is merged in instead of the full payload. Reference the result downstream by expression, e.g. {{ $json.state }} for a deploy or {{ $json.email }} for a simplified form submission.
Usage Examples
- Start a workflow when a Netlify deploy is created
- Send a Slack notification when a Netlify deploy fails
- Trigger a follow-up action when a Netlify deploy starts building
- Capture form submissions from a Netlify-hosted site and save to a database
Example Configuration
Alert on failed deploys:
{
"type": "netlify_trigger",
"parameters": {
"siteId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"event": "deployFailed"
}
}
Track successful deploy creation:
{
"type": "netlify_trigger",
"parameters": {
"siteId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"event": "deployCreated"
}
}
Capture one form’s submissions as plain field data:
{
"type": "netlify_trigger",
"parameters": {
"siteId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"event": "submissionCreated",
"formId": "contact-form",
"simple": true
}
}
Capture every form on the site with the full webhook payload:
{
"type": "netlify_trigger",
"parameters": {
"siteId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"event": "submissionCreated",
"formId": "*",
"simple": false
}
}
Trigger Behavior
- Activation: When the workflow is activated, a webhook endpoint is registered with the service.
- Deactivation: The webhook is automatically unregistered when the workflow is deactivated.
- Payload: The incoming webhook payload is parsed and output as workflow items.
- Verification: Supports signature verification where applicable.
Tips
Entry point that fires when Netlify sends a webhook for a deploy lifecycle event or form submission. Select the Netlify site to monitor and the event type to listen for. For form submissions, optionally scope to a specific form or use “All Forms”. Enable Simplify for form submissions to receive only form field key-value pairs instead of the full payload.
Frequently asked questions
How do I get clean form data?
Enable Simplify for form submissions to receive only the form field key-value pairs instead of the full payload — much easier to map into another system.
Can I watch a single form?
Yes. For form submissions you can scope to a specific form or use All Forms to catch everything on the site.
Which events are available?
Deploy lifecycle events and form submissions, selected when configuring the trigger alongside the site to monitor.
Which credential does it need?
A Netlify credential, the same one the Netlify action node uses.
Build with the Netlify Trigger node
Drop it into a workflow, wire it to an agent, or call it on a schedule. You'll need Netlify credentials first.
Open BusyBotLast updated . Spotted something wrong? Tell us.