Contacts
Preview Segment
Count and sample contacts matching a filter tree without persisting a segment.
POST
/io/contacts/segments/previewEvaluates a filter tree and returns the matched count plus up to 10 sample contacts — without creating a segment.
Request body
filterCriteriaobjectbodyrequiredFilter group: { operator: "AND"|"OR", rules: [...] }.
{
"filterCriteria": {
"operator": "AND",
"rules": [
{ "field": "status", "operator": "eq", "value": "subscribed" },
{ "field": "lead_score", "operator": "gte", "value": 50 }
]
}
}{
"count": 312,
"sample": [
{ "id": "cnt_abc", "email": "[email protected]", "lead_score": 72, "...": "..." }
]
}