API Reference

Contact us

Zapier

Zapier Platform

This URL creates a new Zap based on a series of steps and a given title.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `zap:write` OAuth scope.

Create a Zap

An Action is an operation that can be performed against a third-party API; either a read or a write. A Zap is composed of a read, followed by one or more writes.

The type of this Action

* `READ` - READ
* `WRITE` - WRITE

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 type of this object

* `action` - action

A branded color that can be used 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.

Images/icons of various resolutions to represent the app.

An Authentication contains various fields, often credentials such as API tokens, used to access Partner APIs on
behalf of a user. The actual fields are held securely by Zapier

An app that integrates with Zapier. (Expandable)

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

See [here](/guides/getting-started/Building-a-Zap) to get started.

A unique identifier for this particular occurrence of the problem.

A human-readable explanation specific to this occurrence of the problem.

An object containing references to the primary source of the error.

The HTTP status code applicable to this problem.

Populates the `source` object inside our error responses.

A string indicating the name of a single request header which caused the error.

A string indicating which URI query parameter caused the error.

Pointer to the value in the request document that caused the error e.g. `/actions`.

An ordered list of steps that define the logic of the Zap.

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.

OAuthAccessTokenAuthentication

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

Add automation to your product with Zapier.

Zapier Partner Solutions

Our most powerful tool for building native workflows in your product

Introduction

This guide walks through the entire process of building an automated workflow for your users to use -- front picking apps, adding authentication, filling inputs and publishing.

How to Build a Workflow

Fields and Fieldsets

An Action is an operation that can be performed against a third-party API; either a `READ` or a `WRITE`.

Selecting an Action

Support users in selecting 3rd party authentications, either through an existing authentication or by adding new.

Selecting an Authentication

Creating workflows using the Zapier Workflow API is a recent addition, and there are some known limitations.

Known Limitations

Listing apps available on Zapier is a simple way to show users all of what's possible on Zapier

Retrieving Apps on Zapier

Listing a users zaps reveals existing workflows created by users.

Retrieving a list of users Zaps

Zap templates are pre-made Zaps that help users discover popular use cases for automating their work. Each template features a specific use case and the apps needed for it to work.

Retrieving Zap Templates

With an embedded Zap editor in your product, your users can create and edit their Zaps without leaving your app.

Embedding the Zapier Editor

The Workflow Element is a prebuilt UI component that offers the quickest—and easiest—way to surface your Zapier integration directly within your own product.

Embed the Workflow Element

Keeping our elements secure and usable is critical at Zapier

Element Security

Insights are available to review the performance of your embed, and track usage growth.

Embed Insights

Prefills allow you to define the input fields on behalf of the user, simplying the experience of setting up their Zap.

Pre-filled Zaps

Quick Account Creation is a seamless, accelerated sign-up feature allowing first time Zapier users to skip the standard sign-up procedure and onboarding survey. Enabling Quick Account Creation as part of your embed tool code helps provide a more frictionless experience for end users.

Quick Account Creation

Authenticate with The Zapier Workflow API

Zapier Authentication

Rate limits when accessing the Workflow API   

Rate Limiting

This endpoint returns a list of apps sorted popularity. See [here](/guides/list-apps) to get started.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

Get Apps [v1]

This endpoint returns a list of apps sorted popularity. See [here](/guides/list-apps) to get started.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `zap` OAuth scope.

Get Apps [v2]

List of Zap categories

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

Get Categories

Create a new user and obtain an access token. See [here](/guides/quac/intro-quac#add-support-to-the-workflow-api) to get started.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

Create Account

This endpoint returns the authenticated user information

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `profile` OAuth scope.

User Profile

List popular Zap Templates using your app. See [here](/guides/list-zap-templates) to get started.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

Get Zap Templates

This endpoint returns a list of Zaps for the authenticated Zapier user.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `zap` OAuth scope.

Get Zaps [v1]

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 API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `zap`, or `zap:all` OAuth scope.

Get Zaps [v2]

Fetch the available actions for the provided App. It's typical to filter by type so that only actions that make sense for a particular step are shown. Action IDs may not be reused, see our documentation [here](https://docs.api.zapier.com/guides/custom-flows/Hardcoding-an-Action) for how to hardcode a particular action.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `zap` OAuth scope.

Get Actions

Get the Input Fields for a particular Action, using the provided authentication and inputs.  See [here](/guides/getting-started/Fields-and-Fieldsets) for more information.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `zap:write` OAuth scope.

Get Input Fields

Get the Output Fields for a particular Action, using the provided authentication and inputs.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `zap:write` OAuth scope.

Get Output Fields

Get the possible values for an Input Field that is marked as `SELECT`.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `zap` OAuth scope.

Get Choices

Tests the action (step) in the third party api, using the provided authentication and inputs.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `zap:write` OAuth scope.

Step Test

Fetch the available Authentications for the provided App. This will only return Authentications that are owned by the user and not those that are shared with them, since it's not possible to create Zaps with Authentications you don't own.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `authentication` OAuth scope.

Get Authentications

Creates a new Authentication for the provided App.  See [here](/guides/custom-flows/adding-an-authentication) to get started.

This API is rate limited. See [Rate Limiting](https://docs.api.zapier.com/api-reference/getting-started/rate-limiting) for more details.

#### OAuth
This endpoint requires the `authentication:write` OAuth scope.

Create Authentication

Errors in the API follow the <a href="https://jsonapi.org/format/#error-objects" target="_blank">recommendation</a> from the JSON API spec.

Errors

Pagination

Requests

Responses for the API follow the <a href="https://jsonapi.org/format/#fetching-resources-responses-200" target="_blank">JSON API spec</a> for fetching resources.

Getting Started With the API

Apps

Categories

Accounts

Zap Templates

Zaps

Actions

Authentications

Schemas

Create a Zap

OAuth

Authorizations

Query Parameters

Body

Response