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.
- Verified Nov 22, 2026
- Classic builder
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 #
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_IDto run the workflow without a record.GET workflowslists the workflow IDs;apiTriggerableistruefor the ones you can start. - The API answers
202with aqueueId. The run happens in the background; follow it withGET workflows/history/queue/{queueId}. - A workflow with another trigger answers
422, an inactive one412, and a key without Allow Workflows403.
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.
Was this page helpful?
Something wrong or missing on this page? Tell us.