Create Segment

customer_io.create_segment
ActionCRM & salesconnection required

Calls the Customer.io API with the connection's credentials.

Create a manual segment whose membership this workflow controls. Data-driven segments compute their own membership and can only be defined in the dashboard.

Connection

Required
Yes — the node will not save without one
Auth type
API key
Providers
Customer.io
Secret shape
{"site_id": "…", "api_key": "…", "app_api_key": "…"} — the Site ID and Track API key for the Track nodes, the App API key for the rest
Config it needs
region, workspace_id
Resolved by
config.connection_id, else node.connection_id

Configuration

2 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
name
The segment name, as it will appear in the dashboard.
stringYes———
description
What the segment is for, shown beside it in the dashboard.
stringNo———

Output

One shape.

result

FieldTypeExample
id
The segment's numeric id.
number—
name
The segment name.
string—
description
The segment description, when one is set.
string—
state
The build state of the segment, such as 'finished'.
string—
progress
How far a rebuilding segment has got, as a percentage.
number—
type
'manual' for an API-managed segment, 'dynamic' otherwise.
string—
created_at
When the segment was created, as a Unix timestamp.
number—
updated_at
When the segment last changed, as a Unix timestamp.
number—
{
  "created_at": 0,
  "description": "",
  "id": 0,
  "name": "",
  "progress": 0,
  "state": "",
  "type": "",
  "updated_at": 0
}

See Create Segment run in a workflow.

In a technical demo we add the Customer.io connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.