Create a Zap

Authorizations

Authorization

string

header

required

See our OAuth2 authentication documentation

Query Parameters

expand

string

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

data

object

required

See our Building a Zap guide to get started.

Response

201 - application/json

A Zap is an automated workflow that connects your apps and services together.

string

required

A unique identifier of the Zap.

last_successful_run_date

string | null

required

The date/time at which this Zap last ran successfully. A null value indicates that a Zap has never run successfully.

links

object

required

steps

required

ExpandedZapStep (Expandable)

steps.action

required

Action (Expandable)

steps.action.action_type

enum<string>

required

The type of this Action

READ - READ
WRITE - WRITE

Available options:

action

steps.action.app

required

Apps (Expandable)

steps.action.app.action_types

any[]

required

steps.action.app.categories

object[]

required

A list of categories to which this app belongs. Helpful in identifying apps by type and functionality.

steps.action.app.description

string

required

Human readable description of the app.

steps.action.app.hex_color

string

required

A branded color that can be used to represent the app.

steps.action.app.id

string

required

Unique id of the app

steps.action.app.image

string

required

Default image/icon to represent the app.

steps.action.app.images

object

required

Images/icons of various resolutions to represent the app.

steps.action.app.links

object

required

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.

steps.action.app.title

string

required

Human readable name of the app

steps.action.app.type

string

default:

app

The type of this object.

steps.action.description

string

required

A longer description of this Action, usually describing what it does in more detail.

steps.action.id

string

required

steps.action.is_instant

boolean

required

Will be set to true if this Action triggers instantly. May only be true when type is READ.

steps.action.key

string

required

The developer provided identifier for this Action

steps.action.title

string

required

The title of this Action.

steps.action.type

enum<string>

required

The type of this object

action - action

Available options:

action

steps.authentication

required

Authentication (Expandable)

steps.authentication.app

required

An app that integrates with Zapier. (Expandable)

steps.authentication.app.action_types

any[]

required

steps.authentication.app.categories

object[]

required

A list of categories to which this app belongs. Helpful in identifying apps by type and functionality.

steps.authentication.app.description

string

required

Human readable description of the app.

steps.authentication.app.hex_color

string

required

A branded color that can be used to represent the app.

steps.authentication.app.id

string

required

Unique id of the app

steps.authentication.app.image

string

required

Default image/icon to represent the app.

steps.authentication.app.images

object

required

Images/icons of various resolutions to represent the app.

steps.authentication.app.links

object

required

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.

steps.authentication.app.title

string

required

Human readable name of the app

steps.authentication.app.type

string

default:

app

The type of this object.

steps.authentication.id

string

required

steps.authentication.is_expired

boolean

required

If true, this Authentication has expired. It will not be usable, and the user needs to be directed to reconnect it.

steps.authentication.title

string

required

steps.authentication.type

enum<string>

default:

authentication

required

The type of this object.

authentication - authentication

Available options:

authentication

steps.inputs

any

required

steps.title

string | null

required

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.

title

string

required

The human readable name of the Zap.

type

string

required

The type of this object.

updated_at

string

required

is_enabled

boolean

default:

true

Whether the Zap is enabled (running) or not.

Welcome

Workflow API

Workflow Element

Embed Enhancements

Getting Started With the API

Apps

Categories

Accounts

Zap Templates

Zaps

Actions

Authentications

Experimental

Schemas

Apps

Categories

Accounts

Zap Templates

Zaps

Actions

Authentications

Experimental

OAuth

Authorizations

Query Parameters

Body

Response