Skip to main content
POST
Add a journey node
This endpoint is in alpha and is subject to change at any time.

Authorizations

Authorization
string
header
required

Accepts either a raw API key or Bearer <key>.

Headers

revision
string

Optional dated API revision for the request. Must use YYYY-MM-DD format.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-03-01"

Path Parameters

journey_id
integer
required

Journey ID.

Body

application/json
type
enum<string>
required
Available options:
email,
sms,
push,
delay,
branch,
random_split,
filter,
exit
parent_id
integer
required

Node to insert the new node after.

index
integer

Branch arm to insert on. Omit for a linear parent.

Response

Node added. Returns the updated journey.

A journey with its full graph — its trigger, nodes and edges. Messaging nodes expose message and content metadata but not content bodies or audience details.

id
integer
required
name
string
required

Journey name.

description
string | null
required

Optional journey description. May be null.

status
enum<string>
required

Journey lifecycle status.

Available options:
draft,
active,
paused,
archived,
cancelled
trigger
object | null
required

The event that enters people into the journey. null when none is set.

nodes
object[]
required
edges
object[]
required
created_at
string<date-time>
required
updated_at
string<date-time>
required