Contacts and segments

Contact fields

email (required), name, company, job title, country, city, industry, tags, lead score, status, consent status, source, and arbitrary custom fields.

Consent and suppression

Contacts carry an explicit consent status. Suppressed addresses are excluded from every future campaign send regardless of list or segment membership; suppression is added with add_suppression and checked automatically during preflight.

Static lists vs. dynamic segments

A static list is a fixed set of contact memberships. A dynamic segment is a saved filter — a rule or nested rule group over fields such as email, firstName, lastName, company, jobTitle, country, city, industry, tags, leadScore, status, consentStatus, source, and customFields.<key>. Segments re-evaluate membership at send time.

Filter shape

{
  "op": "and",
  "rules": [
    { "field": "status", "comparator": "eq", "value": "subscribed" },
    { "field": "industry", "comparator": "eq", "value": "real_estate" }
  ]
}

Preview a filter with preview_segment before saving a segment, to verify the matching-contact count and sample.

Related MCP tools

list_contacts, create_contact, update_contact, add_suppression, list_segments, create_segment, update_segment, preview_segment. Full parameters at /mcp-tools.