Materialize a lookalike preview into a static segment
Promote an AI lookalike PREVIEW into a persisted, static contact segment ready for one-click audience activation. Runs the same centroid-k-NN scoring as /expand (so the materialized set equals the preview), then persists the net-new candidates as a NEW static segment (no rules/filters, auto_refresh=false) whose segment_id feeds the CDP audience-activation surface. Returns 201 with materialized: true and the new segment; when the preview yields no candidates it returns 200 with materialized: false and a reason, persisting nothing.
Authorizations
Dashboard JWT token from Clerk
Path Parameters
Body
Number of net-new lookalike contacts to materialize (matches the /expand preview cap so preview equals the materialized set).
1 <= x <= 500Seed members sampled for the centroid (see /expand).
1 <= x <= 200Optional override for the new segment's name; defaults to "Lookalike of ".
1 - 200