Skip to main content
POST
Create a flow

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Where to create the flow and what it contains.

workspaceId
string
required

The workspace to create the flow in, e.g. clx1a2b3c4d5e6f7g8h9. Get it from List workspaces. A workspace your token cannot write to answers 404, indistinguishable from one that does not exist.

typebot
object
required

The flow to create. Only name is mandatory; everything omitted gets its default.

Response

The flow as stored.

A flow as stored after a write. Its updatedAt is the value to send as typebot.updatedAt on the next Update a flow and as expectedUpdatedAt on Publish a flow.

typebot
object
required

A flow with its full definition.