Skip to main content
POST
Create a workflow node

Authorizations

Authorization
string
header
required

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

Path Parameters

workflowId
string
required

The ID of the workflow.

Body

application/json

Create a new workflow node with an explicit insertMode. To configure the node after creation, use the POST /v1/workflows/{workflowId}/nodes/{nodeId} endpoint.

expectedRevisionId
string | null
required

The workflow revision token returned by the latest workflow read or mutation. Older workflows may return null before their first revision-aware mutation; pass null back as expectedRevisionId in that case. If the token is stale, the API returns a 409 Conflict error.

insertMode
enum<string>
required
Available options:
between
nodeTypeName
enum<string>
required

Node types that can be created with the API. *Trigger nodes and ExitAction nodes cannot be created.

Available options:
AudienceFilter,
BranchNode,
ExperimentBranchNode,
TimerAction,
SendEmailAction,
VariantNode
fromNodeId
string
required

The node to insert after. This node must currently point to toNodeId. If this is an ExperimentBranchNode, nodeTypeName must be VariantNode and toNodeId cannot already be a VariantNode.

toNodeId
string
required

The node to insert before.

Response

Workflow node created.

node
object
required

Detailed workflow node returned from a mutation, plus the latest workflow revision token.

workflow
object
required
Example:
Last modified on August 14, 2026