---
title: "Create an Action Run"
method: POST
path: "/v2/action-runs"
tags: ["Experimental"]
---

# Create an Action Run

`POST /v2/action-runs`

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.

Optionally, include a `callback_url` in the request body to receive the result via a POST callback instead of polling.

#### When using OAuth

This endpoint requires the `action:run` OAuth scope.

## Request body

- RunActionRequest
  - `data` RunActionRequest, required — recursive

## Response `200`

- RunActionResponse
  - `data` RunActionResponse, required — recursive

## Other responses

- `400` — This schema can be expected for 4xx 'Malformed request.' errors
- `401` — 401 Response
- `403` — 403 Response
- `409` — 409 Response
- `429` — 429 Response
- `500` — This schema can be expected for 5xx 'A server error occurred.' errors
- `503` — 503 Response
- `504` — 504 Response

---

[API](https://skmtc.dev/zapier/apis/trigger-inbox-api.md) · [All operations](https://skmtc.dev/zapier/apis/trigger-inbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zapier/trigger-inbox-api/revisions/3fc4c2846ba1/schema)