curl --request GET \
--url https://api.zapier.com/v2/zaps \
--header 'Authorization: Bearer <token>'[
{
"links": {
"next": null,
"prev": null
},
"meta": {
"count": 1,
"offset": 0,
"limit": null
},
"data": [
{
"type": "zap",
"id": "00000000-0000-c000-8000-000000012345",
"is_enabled": false,
"last_successful_run_date": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"title": "My Zap",
"links": {
"html_editor": "https://zapier.com/editor/7481?utm_source=partner&utm_medium=embed&utm_campaign=partner_api&referer=zapier"
},
"steps": [
{
"action": "uag:1f188536-6dd0-4172-8414-2b90914ddee9",
"authentication": "QVaPP2O1",
"inputs": {
"deal_stage": "CLOSED_WON"
},
"title": "Pacific Railway Golden spike hammered"
},
{
"action": "uag:1f188536-6dd0-4172-8414-2b90914ddaa7",
"authentication": "MVA64zk4",
"inputs": {
"full_name": "{{customer__full_name}}"
},
"title": "Record who dunnit"
}
]
}
]
}
]This endpoint returns a list of Zaps for the authenticated Zapier user.
The expand array can be used to expand selected fields into full objects in the response. Inputs with keys can
also be passed to filter Zaps by certain criteria.
This endpoint requires the zap, zap:all, or zap:account:all OAuth scopes.
curl --request GET \
--url https://api.zapier.com/v2/zaps \
--header 'Authorization: Bearer <token>'[
{
"links": {
"next": null,
"prev": null
},
"meta": {
"count": 1,
"offset": 0,
"limit": null
},
"data": [
{
"type": "zap",
"id": "00000000-0000-c000-8000-000000012345",
"is_enabled": false,
"last_successful_run_date": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"title": "My Zap",
"links": {
"html_editor": "https://zapier.com/editor/7481?utm_source=partner&utm_medium=embed&utm_campaign=partner_api&referer=zapier"
},
"steps": [
{
"action": "uag:1f188536-6dd0-4172-8414-2b90914ddee9",
"authentication": "QVaPP2O1",
"inputs": {
"deal_stage": "CLOSED_WON"
},
"title": "Pacific Railway Golden spike hammered"
},
{
"action": "uag:1f188536-6dd0-4172-8414-2b90914ddaa7",
"authentication": "MVA64zk4",
"inputs": {
"full_name": "{{customer__full_name}}"
},
"title": "Record who dunnit"
}
]
}
]
}
]See our OAuth2 authentication documentation here: https://docs.zapier.com/powered-by-zapier/api-reference/authentication
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.
If true, all Zaps that are shared with the user, rather than only those owned by them, are returned. If the zap:account:all scope is not present this has no effect.
You may pass inputs[KEY]=VALUE1,VALUE2 to filter for Zaps that contain those settings. Keys are defined by your app on the developer platform.
Used for paginating results. Specifies the maximum number of items to return per page. If this value is not set, it defaults to 10.
Used for paginating results. Specifies the offset to use.
The (potentially) expanded data for Zaps that matched the request
Show child attributes
The type of this object.
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.
The last time this Zap was updated
The human readable name of the Zap.
A list of the steps this Zap consists of
An ordered list of steps that define the logic of the Zap.
Show child attributes
Action
Show child attributes
The ID to refer to this action (unstable, may change when referenced app changes)
The developer provided identifier for this Action (stable)
Apps
Show child attributes
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. Client ID-authenticated requests will never have this object's fields populated.Show child attributes
A list of action types for this specific App
Human readable name of the app
The URL of images (of various sizes) for this specific App
Show child attributes
16x16 resolution image URL
32x32 resolution image URL
64x64 resolution image URL
128x128 resolution image URL
A branded color that can be used to represent the app.
Human readable description of the app.
The type of this object.
The type of this object
action - actionaction The type of this Action
READ - READREAD_BULK - READ_BULKWRITE - WRITESEARCH - SEARCHSEARCH_OR_WRITE - SEARCH_OR_WRITESEARCH_AND_WRITE - SEARCH_AND_WRITEFILTER - FILTERaction Will be set to true if this Action triggers instantly. May only be true when type is READ.
The title of this Action.
A longer description of this Action, usually describing what it does in more detail.
Authentication
Show child attributes
The type of this object.
authentication - authenticationauthentication The identifier for this specific Authentication
An app that integrates with Zapier.
Show child attributes
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. Client ID-authenticated requests will never have this object's fields populated.Show child attributes
A list of action types for this specific App
Human readable name of the app
The URL of images (of various sizes) for this specific App
Show child attributes
16x16 resolution image URL
32x32 resolution image URL
64x64 resolution image URL
128x128 resolution image URL
A branded color that can be used to represent the app.
Human readable description 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 title of this specific Authentication
The inputs for this specific Zap's step
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.
Whether the Zap is enabled (running) or not.
Was this page helpful?