# Can I start a workflow from the REST API?

> Yes. The Workflows API starts active workflows that use the Manual trigger, for the whole table or one record, and reads their run history.

Source: https://tadabase.com/docs/faq/can-i-start-a-workflow-from-the-api  
Status: Verified Nov 22, 2026. Checked against the current product

Yes. The Workflows API starts any active workflow that uses the **Manual** trigger, either on its own or for one record, and reads the run history of every workflow in the app. Your plan must include API access, Workflows and workflows through the API, and the API key needs **Allow Workflows** turned on.

## The request

```bash
curl -X POST https://api.tadabase.io/api/v1/workflows/run/WORKFLOW_ID/record/RECORD_ID \
  -H "X-Tadabase-App-Id: YOUR_APP_ID" \
  -H "X-Tadabase-App-Key: YOUR_API_KEY" \
  -H "X-Tadabase-App-Secret: YOUR_API_SECRET"
```

- Leave out `/record/RECORD_ID` to run the workflow without a record. `GET workflows` lists the workflow IDs; `apiTriggerable` is `true` for the ones you can start.
- The API answers `202` with a `queueId`. The run happens in the background; follow it with `GET workflows/history/queue/{queueId}`.
- A workflow with another trigger answers `422`, an inactive one `412`, and a key without **Allow Workflows** `403`.

To have another system start a workflow without an API key, give the workflow the **Incoming Webhook** trigger instead. Full reference: [Run workflows through the API](https://tadabase.com/docs/developers/workflows-api).
