Materialise a predictive-model segment
Re-scores the model’s scoring population with the current cached fit and materialises the top limit (default 50, max 500) ranked profiles into a NEW static segment — the one-click ‘create an at-risk / high-value audience’ step. Returns 201 with the created segment and member count, 422 with the fit report when the model cannot be fitted yet, or 200 with materialized: false when the population is empty (no segment is written). Because activation WRITES a segment, this endpoint requires the contacts:write scope (the other predictive-model endpoints only need contacts:read).
Path Parameters
Model key from GET /api/v1/cdp/predictive-models (also uplift for the persuadability endpoints).
churn_propensity, conversion_intent, lifetime_value, engagement_fatigue