Welcome
Workflow API
Workflow Element
Embed Enhancements
Getting Started With the API
Categories
Accounts
Zap Templates
Authentications
Experimental
Schemas
- Common Types
Categories
Accounts
Zap Templates
Authentications
Experimental
Create a Zap
This URL creates a Zap based on the given steps and title.
OAuth
This endpoint requires the zap:write
OAuth scope.
curl --request POST \
--url https://api.zapier.com/v2/zaps \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"data": {
"steps": [
{
"action": "example_core:5m2y9p7J",
"inputs": {
"code": "output = [{id: Math.round(Date.now()/1000), n: Math.random()}];"
},
"authentication": null
},
{
"action": "example_core:VBz2NGB5",
"inputs": {
"code": "output = [{ id: inputData.id, n: inputData.n * 2}];",
"inputs": {
"n": "{{n}}",
"id": "{{id}}"
}
},
"authentication": null
}
],
"title": "My Critically Important Program"
}
}'
{
"type": "zap",
"id": "104826178",
"is_enabled": true,
"last_successful_run_date": null,
"updated_at": "2024-03-14T22:02:36+00:00",
"title": "My Critically Important Program",
"links": {
"html_editor": "https://zapier.com/editor/104826178?utm_source=partner&utm_medium=embed&utm_campaign=partner_api&referer=None",
"steps": [
{
"action": "example_core:Vn7xbE60",
"authentication": "Krjvl500",
"inputs": {},
"title": null
},
{
"action": "example_core:V7GpzX40",
"authentication": null,
"inputs": null,
"title": null
}
]
}
}
Authorizations
See our OAuth2 authentication documentation
Query Parameters
A comma separated list of Zap fields that should be expanded from ids to full objects in the response. Fields that may not be expanded will remain as ids.
Body
Response
A Zap is an automated workflow that connects your apps and services together.
A unique identifier of the Zap.
The date/time at which this Zap last ran successfully. A null value indicates that a Zap has never run successfully.
ExpandedZapStep (Expandable)
Action (Expandable)
The type of this Action
READ
- READWRITE
- WRITE
action
Apps (Expandable)
A list of categories to which this app belongs. Helpful in identifying apps by type and functionality.
Human readable description of the app.
A branded color that can be used to represent the app.
Unique id of the app
Default image/icon to represent the app.
A url that, when visited, will direct the user to authenticate with the app and allow Zapier access to the app, thus creating a new Authentication.
If value is `null`, then no authentication is required to use the app.
Human readable name of the app
The type of this object.
A longer description of this Action, usually describing what it does in more detail.
Will be set to true
if this Action triggers instantly. May only be true
when type
is READ
.
The developer provided identifier for this Action
The title of this Action.
The type of this object
action
- action
action
Authentication (Expandable)
An app that integrates with Zapier. (Expandable)
A list of categories to which this app belongs. Helpful in identifying apps by type and functionality.
Human readable description of the app.
A branded color that can be used to represent the app.
Unique id of the app
Default image/icon to represent the app.
A url that, when visited, will direct the user to authenticate with the app and allow Zapier access to the app, thus creating a new Authentication.
If value is `null`, then no authentication is required to use the app.
Human readable name of the app
The type of this object.
If true
, this Authentication has expired. It will not be usable, and the user needs to be directed to reconnect it.
The type of this object.
authentication
- authentication
authentication
The custom title of a Zap Step. If a step has not been given a custom title by the user, then the value will be null.
The human readable name of the Zap.
The type of this object.
Whether the Zap is enabled (running) or not.
curl --request POST \
--url https://api.zapier.com/v2/zaps \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"data": {
"steps": [
{
"action": "example_core:5m2y9p7J",
"inputs": {
"code": "output = [{id: Math.round(Date.now()/1000), n: Math.random()}];"
},
"authentication": null
},
{
"action": "example_core:VBz2NGB5",
"inputs": {
"code": "output = [{ id: inputData.id, n: inputData.n * 2}];",
"inputs": {
"n": "{{n}}",
"id": "{{id}}"
}
},
"authentication": null
}
],
"title": "My Critically Important Program"
}
}'
{
"type": "zap",
"id": "104826178",
"is_enabled": true,
"last_successful_run_date": null,
"updated_at": "2024-03-14T22:02:36+00:00",
"title": "My Critically Important Program",
"links": {
"html_editor": "https://zapier.com/editor/104826178?utm_source=partner&utm_medium=embed&utm_campaign=partner_api&referer=None",
"steps": [
{
"action": "example_core:Vn7xbE60",
"authentication": "Krjvl500",
"inputs": {},
"title": null
},
{
"action": "example_core:V7GpzX40",
"authentication": null,
"inputs": null,
"title": null
}
]
}
}