Create an audience from analytics events
Creates a frozen audience snapshot from the same membership filters as /events: 1–10 canonical event types, an absolute window up to 90 days, optional send/email ids, multi-select automation/audience ids, recipient include/exclude rules, and the machine-click policy. Every call generates a unique date field; each matching existing contact stores its latest matching-event timestamp. Returns 201 immediately with materializationStatus: pending plus build progress. The audience is unavailable for campaign, smart-send, and automation delivery until the status becomes ready. Failed/partial/stale builds remain non-sendable and partial values are cleaned. Poll GET /v1/audiences?audienceId=…&include=build.
Authorizations
Send your Brew API key as Authorization: Bearer brew_xxx.
Headers
Optional idempotency key for safe retries. Reusing the same key with the same request body returns the original response for 24 hours.
1 - 100The brand this request acts on. REQUIRED for organization-scoped credentials (otherwise 400 BRAND_ID_REQUIRED — there is no default brand); list ids with GET /v1/brands. Brand-scoped credentials may omit it, and sending a different brand returns 403 BRAND_SCOPE_MISMATCH. A brand outside your organization returns 404 BRAND_NOT_FOUND.
1 - 64Response
Created. The audience exists immediately; build tracks the background stamping run.
1 - 641 - 200x >= 0pending, running, ready, failed