Contacts & events
Upsert contacts + tags, segment them, and emit events that trigger automations.
email_upsert_contact
WRITE — Create or update a contact (attributes shallow-merge; tags REPLACE the set when given).
email_get_contact
READ — One contact: profile + suppression state + recent events + recent messages.
email_list_contacts
READ — List contacts (newest first).
email_import_contacts
WRITE — Bulk-import contacts when migrating a company in (CSV rows parsed to entries).
email_emit_contact_event
WRITE — Manually emit a contact event — the way to TEST-DRIVE automation triggers end to end (enrollment happens exactly as with API events).
email_list_events
READ — Event catalog: the contact-event names this project has received, with volume and last-seen — the vocabulary automations can trigger on.
email_delete_contact
WRITE — Permanently delete one contact (a data-deletion request).
email_list_segments
READ — List the company's contact segments (saved filters) with their persisted member counts.
email_create_segment
WRITE — Create a named segment from a filter over contact attributes ⊕ tags (paths like 'contact.attributes.plan' or bare attribute keys; ops eq/neq/exists/not_exists/in/gt/lt/contains).
email_update_segment
WRITE — Update a segment's name, description, and/or filter.
email_delete_segment
WRITE — Delete a segment.
email_refresh_segment_count
WRITE — Recompute a segment's member count now by evaluating its filter against current contacts (up to 50k scanned).