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 #

Shell
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.

Was this page helpful?

Something wrong or missing on this page? Tell us.