What is an Action Run?
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 arun_id that you can use to check the run’s status and result.
Understanding Action Runs vs. Zaps
Action Runs differ from Zaps in how they’re created and executed:- A Zap is a saved, user-owned workflow (trigger → actions) stored and managed by Zapier.
- An Action Run is a one-off action your app triggers through the Workflow API. Zapier executes the action but doesn’t store the workflow definition.
- Action Runs are stateless: data is retained briefly (7 days) for processing and troubleshooting, then automatically deleted. You should store any request or response data needed for visibility or support.
Example / Demo
Prerequisites
Before you begin, make sure:- You have access to a public Zapier integration.
- You’ve registered your app and authenticated to use the API.
- You have at least one action configured in your integration, with required fields and sample data tested in the Zapier UI or via the API.
- You’ve had your integration added to the Action Runs allowlist
View our guides for more information
- Step 1: Trigger an Action Run
- Step 2: Retrieve the Action Run Result