Appearance
Netlify
Deploy sites, manage DNS, and configure build hooks with the Netlify API.
| Detail | Value |
|---|---|
| Category | Cloud & Infra |
| Base URL | https://api.netlify.com/api/v1 |
| Authentication | Bearer Token |
| Endpoints | 5 |
| Connector key | netlify |
Using Netlify in a workflow
- Go to Connections and click New Connection.
- Pick Netlify from the marketplace.
- Enter your credentials (see Authentication above for what's expected).
- In a workflow, drop an API Call node and select this connection.
- Pick the operation you need from the Operation dropdown — the full list is below.
Available endpoints
| Endpoint | Summary |
|---|---|
GET /sites | List all sites |
GET /sites/{site_id} | Get a site by ID |
POST /sites | Create a new site |
GET /sites/{site_id}/deploys | List deploys for a site |
POST /hooks | Create a notification hook |
Each endpoint is documented in full below. Use the outline on the right to jump to one.
GET /sites
List all sites
| Detail | Value |
|---|---|
| Operation ID | hosting.listSites |
| Method | GET |
| Path | /sites |
Parameters
| Name | Location | Type | Required |
|---|---|---|---|
page | query | integer | No |
per_page | query | integer | No |
Using this endpoint in a workflow
- Add an API Call node to your workflow.
- Pick your Netlify connection from the Connection dropdown.
- In the Operation dropdown, select
hosting.listSites. - Fill in the parameter fields that appear. Use
{{...}}to reference upstream values.
What it returns
The API Call node writes the response to the workflow context:
{
status: 200,
success: true,
data: { ...response body from the API... },
latencyMs: 142
}Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Netlify API reference.
GET /sites/{site_id}
Get a site by ID
| Detail | Value |
|---|---|
| Operation ID | hosting.getSite |
| Method | GET |
| Path | /sites/{site_id} |
Parameters
| Name | Location | Type | Required |
|---|---|---|---|
site_id | path | string | Yes |
Using this endpoint in a workflow
- Add an API Call node to your workflow.
- Pick your Netlify connection from the Connection dropdown.
- In the Operation dropdown, select
hosting.getSite. - Fill in the parameter fields that appear. Use
{{...}}to reference upstream values.
Required fields are marked — fill them or the call will fail at runtime.
What it returns
The API Call node writes the response to the workflow context:
{
status: 200,
success: true,
data: { ...response body from the API... },
latencyMs: 142
}Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Netlify API reference.
POST /sites
Create a new site
| Detail | Value |
|---|---|
| Operation ID | hosting.createSite |
| Method | POST |
| Path | /sites |
Parameters
No parameters.
Request Body
| Field | Type |
|---|---|
name | string |
custom_domain | string |
Using this endpoint in a workflow
- Add an API Call node to your workflow.
- Pick your Netlify connection from the Connection dropdown.
- In the Operation dropdown, select
hosting.createSite. - Fill in the parameter fields that appear. Use
{{...}}to reference upstream values.
Required fields are marked — fill them or the call will fail at runtime.
What it returns
The API Call node writes the response to the workflow context:
{
status: 200,
success: true,
data: { ...response body from the API... },
latencyMs: 142
}Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Netlify API reference.
GET /sites/{site_id}/deploys
List deploys for a site
| Detail | Value |
|---|---|
| Operation ID | hosting.listDeploys |
| Method | GET |
| Path | /sites/{site_id}/deploys |
Parameters
| Name | Location | Type | Required |
|---|---|---|---|
site_id | path | string | Yes |
Using this endpoint in a workflow
- Add an API Call node to your workflow.
- Pick your Netlify connection from the Connection dropdown.
- In the Operation dropdown, select
hosting.listDeploys. - Fill in the parameter fields that appear. Use
{{...}}to reference upstream values.
Required fields are marked — fill them or the call will fail at runtime.
What it returns
The API Call node writes the response to the workflow context:
{
status: 200,
success: true,
data: { ...response body from the API... },
latencyMs: 142
}Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Netlify API reference.
POST /hooks
Create a notification hook
| Detail | Value |
|---|---|
| Operation ID | hosting.createHook |
| Method | POST |
| Path | /hooks |
Parameters
No parameters.
Request Body
| Field | Type |
|---|---|
site_id | string |
type | string |
event | string |
Using this endpoint in a workflow
- Add an API Call node to your workflow.
- Pick your Netlify connection from the Connection dropdown.
- In the Operation dropdown, select
hosting.createHook. - Fill in the parameter fields that appear. Use
{{...}}to reference upstream values.
Required fields are marked — fill them or the call will fail at runtime.
What it returns
The API Call node writes the response to the workflow context:
{
status: 200,
success: true,
data: { ...response body from the API... },
latencyMs: 142
}Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Netlify API reference.