Skip to main content
POST
/
workflows
cURL
curl -X POST \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"name": "My Scripted Workflow", "team_id": "YOUR_TEAM_ID", "is_external": false, "canvas_type": 0, "public": false}' \
  '$BASE_URL/workflows'
{
  "id": "d0763222-8f38-46aa-a96e-2532038e49b8",
  "name": "My Scripted Workflow"
}

Headers

​
x-api-key
string
required

Your API key. This is required by most endpoints to access the API programmatically. You can view your x-api-key using the 'Profile' tab on the website.

​
Authorization
string
required

Bearer token for authentication (JWT).

Body

application/json

JSON data defining the workflow to be created.

​
name
string

Name of the workflow.

​
team_id
string

UUID of the team with which this workflow is associated.

​
is_external
boolean

Indicates if the workflow is an external one.

​
canvas_type
integer

Canvas type (0 for basic, 1 for advanced, etc.).

​
public
boolean

Whether the workflow is public or private.

Response

Successfully created workflow (some code returns 200). Returns the new workflow in JSON.

​
id
string

The newly created workflow’s UUID.

​
name
string

Name of the newly created workflow.