Back

Build completed

This trigger fires when a build on your Netlify site finishes, whether it succeeded or failed. Use the BuildState ingredient to branch on the outcome.

Developer info

API endpoint slug: netlify.build_completed

Trigger fields

Site Dropdown list

Label: Site
Helper text: Select a Netlify site to monitor.
Slug: site_id
Required: true
Can have default value: false

Ingredients

Build

Slug: build_id
Filter code: Netlify.buildCompleted.BuildId
Type: String
Example: 5d9c3e3e8a1b2c3d4e5f6789

Site

Slug: site_id
Filter code: Netlify.buildCompleted.SiteId
Type: String
Example: abc12345-6789-0abc-def0-123456789abc

Site name

Slug: site_name
Filter code: Netlify.buildCompleted.SiteName
Type: String
Example: my-cool-site

Site url

Slug: site_url
Filter code: Netlify.buildCompleted.SiteUrl
Type: Web URL
Example: https://my-cool-site.netlify.app

Build state Either "ready" (successful) or "error" (failed).

Slug: build_state
Filter code: Netlify.buildCompleted.BuildState
Type: String
Example: ready

Branch

Slug: branch
Filter code: Netlify.buildCompleted.Branch
Type: String
Example: main

Commit ref

Slug: commit_ref
Filter code: Netlify.buildCompleted.CommitRef
Type: String
Example: f3a1b2c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0

Deploy url Unique URL for the deploy. Empty when the build failed.

Slug: deploy_url
Filter code: Netlify.buildCompleted.DeployUrl
Type: String
Example: https://5d9c3e3e--my-cool-site.netlify.app

Error message Reason the build failed. Empty on success.

Slug: error_message
Filter code: Netlify.buildCompleted.ErrorMessage
Type: String
Example: Hello World!

Completed at

Slug: completed_at
Filter code: Netlify.buildCompleted.CompletedAt
Type: Date with time (ISO8601)
Example: 2020-07-08T04:17:06+05:00

Applets using this Trigger