Skip to main content
POST
Create workflow

Authorizations

Authorization
string
header
required

Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.

Body

application/json

Create a new workflow (master + version 1) from a full definition. Created as DRAFT unless activate is true.

workspace_id
string
required

Workspace to create the workflow in

name
string
required

Workflow name

Minimum string length: 1
steps
object[]
required

The step graph.

description
string | null
color
string

Hex color for the workflow, e.g. #2563eb

trigger
object | null

The workflow trigger, or null for a trigger-less workflow.

first_step_id
string | null

Id of the entry step, or null.

activate
boolean

When true, the version goes live (status ACTIVE). Defaults to false (DRAFT).

Response

Created workflow definition

Full workflow definition: metadata, trigger, and the step graph (steps + derived edges) as the Workflows editor stores it. Embedded secrets are redacted.

data
object
required