Skip to main content
A segment is a saved question (“who is in?”). A tag sticks to the file; a segment combines rules with AND/OR. Always Preview before large campaigns.

What is a segment?

A dynamic audience defined by JSON rules (version: 1). When you run a campaign, the system reapplies the same rules. Analogy: a tag is a label on the folder. A segment is the saved search.

Segment × tag × topic × campaign

Format (version 1)

Rule types (5)

Quick examples

Tag + marketing:
Full operators per field type: API reference (Segments group).
No type: "channel" rule. For phone use hasPhone or phone. For Telegram use hasTelegram or telegramPeer.

Preview and campaigns

Preview (segments:read), paginated sample (max 500 per page via limit; default 20) with id, name, phone, email, receiveMarketing. pagination.totalCapped is set when the estimated total hits the internal ceiling (10.000). In campaigns, pick the segment as audience. On Run, rules execute again.

Next steps