Audience segments

The audience-segments command reads and creates audience segments, which are used to target campaigns and for filtering inside workflows.

`create`

Create a new audience segment. Provide the audience filter inline with --filter or from a JSON file with --filter-file. Set the filter inline with --filter:

loops audience-segments create \
  --name "Pro plan contacts" \
  --filter '{"match":"all","conditions":[{"type":"property","key":"plan","operator":"equals","value":"pro"}]}'

Alternatively, load the filter from a JSON file with --filter-file:

filter.json

{
  "match": "all",
  "conditions": [
    { "type": "property", "key": "plan", "operator": "equals", "value": "pro" }
  ]
}

loops audience-segments create \
  --name "Pro plan contacts" \
  --filter-file ./filter.json

The full audience filter schema is documented in the API reference.

Flags

Flag	Short	Description
`--name`	`-n`	Segment name Required
`--description`		Segment description
`--filter`		Audience filter as an inline JSON string
`--filter-file`		Path to a JSON file with the audience filter

`get`

Get an audience segment by ID.

loops audience-segments get cln0y4p6r003yl70i1j2k3l4m

`list`

List audience segments.

loops audience-segments list

Pass --pick to filter the list interactively with fzf and copy the selected audience segment ID to your clipboard. Requires fzf to be installed and on your PATH.

loops audience-segments list --pick

Flags

Flag	Description
`--pick`	Interactively pick an audience segment and copy its ID to the clipboard. Requires fzf.
`--per-page`	Results per page (10–50, default 20)
`--cursor`	Pagination cursor for a specific page

Learn

API

CLI

Guides

Audience segments

`create`

Flags

`get`

`list`

Flags

​create

​Flags

​get

​list

​Flags

`create`

Flags

`get`

`list`

Flags