MarketingUpdated 2026-06-01

Audiences & segments

Create rule-based customer segments for targeted campaigns.

Audiences are rule-based customer groups. Instead of blasting everyone, target segments like "VIP customers who haven't ordered in 30 days".

Creating a segment

Marketing → Audiences. Define rules based on customer attributes and order history. Before saving, preview the matching customer count to see how many shoppers qualify. You can also browse the customers in a segment.

Segment endpoints
GET/marketing/segments/list
List segments.
Session
POST/marketing/segments/create
Create a rule-based customer segment.
Session
GET/marketing/segments/:id/preview
Preview matching customer count.
Session
GET/marketing/segments/:id/customers
Paginated customers in a segment.
Session
DELETE/marketing/segments/delete/:id
Delete a segment.
Session

Combine with auto-segments

Customer auto-segments (New, Returning, VIP) are always available. Use the segment builder for custom rules on top — like spend thresholds, order counts, or recency.