Skip to main content
POST
Create a flow

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Body

application/json
name
string
required
Required string length: 1 - 200
definition
object
required

Builder graph — nodes and edges.

trigger_type
enum<string>
required
Available options:
manual,
webhook,
schedule,
event,
workflow
description
string
Maximum string length: 1000
cron_expr
string

5-field cron expression; required when trigger_type is schedule.

Maximum string length: 200
cron_tz
string

IANA timezone for cron_expr (defaults to UTC).

Maximum string length: 64

Response

201 - application/json

The created flow.

data
object

A saved automation flow — its builder graph (definition), trigger configuration, lifecycle status, and current version.

meta
object