Our Action endpoints enable you to programmatically run Zapier-powered actions inside your product. This is especially useful for offering automation natively—without needing your users to build full workflows themselves.
This guide walks you through how to initiate and monitor an action run using the API. By the end, you’ll be able to trigger any Zapier-powered action (like sending an email, updating a spreadsheet, or creating a record in another app) and retrieve the result, all from within your app.
An action run represents a single execution of an action step in a Zapier workflow. When you call the Action Run API, Zapier executes the action logic and returns a run_id
that you can use to check the run’s status and result.
See a walkthrough of how to run one-off actions using the WorkflowAPI.
Before you begin, make sure:
To trigger an action, make a POST
request to /v2/action-runs/
Field | Type | Description |
---|---|---|
action | string | The unique identifier of the action you want to run. |
authentication | string | The authentication id needed to run this action. |
input | object | Key-value pairs of input fields required by the action. |
You can use this run’s id
to poll for the run’s status and result.
To check the outcome of the action, send a GET
request to /v2/action-runs/
Status | Meaning |
---|---|
queued | The run is waiting to be processed. |
running | The action is currently being executed. |
success | The run completed successfully. |
error | An error occurred while executing the run. |
If successful, the results
field will contain the result of the action. You can surface this directly to the user or trigger a follow-up process.
Our Action endpoints enable you to programmatically run Zapier-powered actions inside your product. This is especially useful for offering automation natively—without needing your users to build full workflows themselves.
This guide walks you through how to initiate and monitor an action run using the API. By the end, you’ll be able to trigger any Zapier-powered action (like sending an email, updating a spreadsheet, or creating a record in another app) and retrieve the result, all from within your app.
An action run represents a single execution of an action step in a Zapier workflow. When you call the Action Run API, Zapier executes the action logic and returns a run_id
that you can use to check the run’s status and result.
See a walkthrough of how to run one-off actions using the WorkflowAPI.
Before you begin, make sure:
To trigger an action, make a POST
request to /v2/action-runs/
Field | Type | Description |
---|---|---|
action | string | The unique identifier of the action you want to run. |
authentication | string | The authentication id needed to run this action. |
input | object | Key-value pairs of input fields required by the action. |
You can use this run’s id
to poll for the run’s status and result.
To check the outcome of the action, send a GET
request to /v2/action-runs/
Status | Meaning |
---|---|
queued | The run is waiting to be processed. |
running | The action is currently being executed. |
success | The run completed successfully. |
error | An error occurred while executing the run. |
If successful, the results
field will contain the result of the action. You can surface this directly to the user or trigger a follow-up process.