Skip to main content
POST
/
automations
/
{id}
/
run
Run automation (manual API)
curl --request POST \
  --url http://api.gu1.ai/automations/{id}/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entityId": "<string>",
  "transactionId": "<string>",
  "data": {}
}
'

​
Endpoint

POST https://api.gu1.ai/automations/:id/run
Content-Type: application/json
Only automations with triggerType: "manual_execution" are allowed. Uses runAutomationById — creates an execution row when the workflow has wait steps, and may return waiting: true.

​
Body

​
entityId
string
Optional UUID — loads entity into event.data
​
transactionId
string
Optional UUID — sets transaction context (entityType: transaction)
​
data
object
Merged into event.data (custom fields, phone, email for notifications, etc.)

​
Response

200 (completed) — { "success": true, "message": "Automation run completed.", "automationId": "..." } 200 (standby) — includes waiting: true, executionId, callbackToken, pausedAtStep, totalSteps, pausedAtNodeId, nextNodeId as applicable 403 — trigger is not manual_execution 404 — not found or archived