Skip to main content

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.

To check the outcome of the action, send a GET request to /v2/action-runs/

Request Example

GET https://api.zapier.com/v2/action-runs/arun_abc123/
Authorization: Bearer YOUR_ACCESS_TOKEN

Possible Statuses

StatusMeaning
queuedThe run is waiting to be processed.
runningThe action is currently being executed.
successThe run completed successfully.
errorAn error occurred while executing the run.

Response Example

{
  "data": {
    "type": "run",
    "run_id": "arun_abc123",
    "status": "success",
    "results": {
      // Action result data here
    },
    "errors": []
  }
}
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.
I