Skip to main content
A Segment is a rule-based slice of your user base. Segments power audience targeting for experiments, no-code screens, remote config, and scheduled reports. v4 separates user-defined segments (fully editable) from system segments (managed by Qonversion).

​
Key concepts

  • Rules — Boolean combinations of predicates over user properties, purchases, and identity fields.
  • System segments — Read-only, predefined segments (e.g., active subscribers, churned users).
  • Uses — Segments can be referenced by experiments, scheduled reports, and automations.

​
Condition shape

Each condition has the same four fields: Rules are joined with logical AND — every condition must hold for a user to fall into the segment. PUT /segments/{segment_id} is a full replace: pass the complete condition set you want to keep, or [] to clear. Omit the field entirely to leave conditions untouched. Example create body:

​
Available endpoints

​
Authentication

All v4 endpoints require a Secret Key. See Authentication.