Create an Action Run

curl --request POST \
  --url https://api.zapier.com/v2/action-runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "action": "example_core:Vn7xbE60",
    "authentication": "example_QVaAreV1",
    "inputs": {
      "email": "me@example.com"
    }
  }
}'

{
  "data": {
    "type": "run",
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

API Specification

Create an Action Run

Runs an action (step) in the third party API, using the provided authentication and inputs.

This endpoint is asynchronous, and the response will contain an Action Run ID. You can use the /v2/action-runs/:id endpoint to check the status of the run and retrieve the results.

The authentication field is optional and may be omitted if the action does not require an authentication.

The inputs field is required and must contain the input values for the action.

OAuth

This endpoint requires the action:run OAuth scope.

POST

action-runs

Create an Action Run

curl --request POST \
  --url https://api.zapier.com/v2/action-runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "action": "example_core:Vn7xbE60",
    "authentication": "example_QVaAreV1",
    "inputs": {
      "email": "me@example.com"
    }
  }
}'

{
  "data": {
    "type": "run",
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Running actions via the Workflow API is currently in limited beta. If you would like access to run actions, please use this form to request access.

This API is rate limited.

Authorizations

Authorization

string

header

required

See our OAuth2 authentication documentation here: https://docs.zapier.com/powered-by-zapier/api-reference/authentication

Body

application/json

data

object

required

Data for the Action Run

Show child attributes

Response

data

object

required

The response after an Action Run

Show child attributes

Retrieving Action Run Results Retrieve Action Run

⌘I

Powered By Zapier

API Authentication

Embedding Zapier

Embedding Zapier MCP

Zap Creation

Running Actions

Sponsor User Automation

Managing App Authentications

Zap Templates

AI Workflows

API Specification

Create an Action Run

OAuth

Authorizations

Body

Response