POST /api/flows

Create a new flow using an encoded flow definition.

New objects within the flow definition, such as actions, will need to use a temporary_id field for identification. These will be replaced with traditional id fields after successful creation.

A successful request will return the new definition to you.

Rate limits:
Burst: 1/s
Steady: 15/m
Daily: 100/d

Scopes: flows:write

Servers

Request headers

Name Type Required Description
revision String Yes

API endpoint revision (format: YYYY-MM-DD[.suffix])

Default value: "2025-04-15"

Query parameters

Name Type Required Description
additional-fieldsflow[] Array No

Request additional fields not included by default in the response. Supported values: 'definition'

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.