Create a workflow node
Create a new default workflow node and return it with the latest workflow
insertMode:
betweenplaces it between an existingfromNodeId->toNodeIdconnectionbeforeplaces it beforebeforeNodeId.
BranchNode creates two AudienceFilter children, and ExperimentBranchNode creates two regular VariantNode children plus one control VariantNode.
Public workflows can have up to 300 nodes. Generated children count toward that limit, so a normal create adds 1 node, BranchNode adds 3, and ExperimentBranchNode adds 4. To add a new branch or experiment branch, use the POST /v1/workflows/{workflowId}/nodes/{nodeId}/add-branch endpoint instead.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The ID of the workflow.
Body
- Option 1
- Option 2
Create a new workflow node with an explicit insertMode. To configure the node after creation, use the POST /v1/workflows/{workflowId}/nodes/{nodeId} endpoint.
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.
between Node types that can be created with the API. *Trigger nodes and ExitAction nodes cannot be created.
AudienceFilter, BranchNode, ExperimentBranchNode, TimerAction, SendEmailAction, VariantNode The node to insert after. This node must currently point to toNodeId.
The node to insert before.
Related topics
API IntroductionCreate a workflowDelete a workflow nodeGet a workflow nodeUpdate a workflow node
