Flows

Create a flow

Creates a DRAFT from a definition (see GET /flows/nodes for the catalogue). The definition is validated first: structure, per-node config, the plan's node cap, channel compatibility with the trigger source, keyword collisions with active flows, and references to custom fields, comment triggers and other flows (422 invalid_definition with errors[] and warnings[]). Nothing runs until you publish and activate. The visual builder lays the nodes out the first time the flow is opened. Requires the write scope.

post/flows

Request

  • Base URL: https://sumgenius.ai/api/v1
  • URL: https://sumgenius.ai/api/v1/flows
  • Auth: one of:
    • API key in header X-SumGenius-Api-Key
    • HTTP bearer

Request body

namestring required
channelsstring[]

Must be channels the trigger source can fire on.

tag_idinteger nullable

Tag applied to people who enter the flow. Pro plans and above; ignored otherwise.

Response

201 created

Changes

No recorded changes to this operation across all 1 revision of this API.