Create Workflow
POST/api/automation/workflows
Create a new workflow in Draft status from a node/edge graph. The workflow's trigger type is derived automatically from the trigger node in the graph.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Body fields: name (required, string, max 128), description (optional), category (optional, string, max 50), nodes (required array - may be empty while drafting), edges (required array), viewport (optional canvas position object).
Use List Workflow Node Types to discover valid nodes[*].type values and each node's settings. Draft workflows are not executable until published.
Request
Responses
- 201
- 401
- 403
- 422
- 429
Created
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.