API
Audiences API
Create, preview, and suggest live segments.
Audiences are live rule trees, not static lists.
Endpoints: listProjectAudiences, createAudience, getProjectAudience, updateAudience, deleteAudience, previewAudience, getAudienceReach, createAudienceSuggestions
Scope: read to list/preview; write to create/update/suggest.
Definition shape
Conditions are a declarative AST: groups with and / or, children that are field, event, or tag rules. At most 25 top-level entries per group.
Always preview (previewAudience) before you save a production audience. A typo that matches zero people is cheaper to catch here than in a live Journey.
Suggestions
createAudienceSuggestions asks Audryo to propose segments from confirmed data and product facts. Each suggestion includes rationale and estimated size. Applying one still creates a normal, editable audience — nothing activates a Journey.
Idempotency: send Idempotency-Key on suggestion requests (LLM-backed).
Reach
getAudienceReach is the current membership count (and sample) for a saved audience. It moves as contacts and events change; you do not re-sync the audience itself.