Creates a new segment on the specified newsletter list.

Required Fields

• name — the display name of the segment

Optional Fields

• description — internal description
• backgroundColor — hex color code (e.g. #ffc1d8) shown in the segment list
• conditions — filter rules (groups + groupOperators structure). If omitted, the segment matches all subscribers.

Conditions Format

Pass a conditions object with groups (array of condition groups) and groupOperators (array of AND/OR connectors between groups).
See the SegmentConditions schema for the full structure.