Contacts

Search contacts in this organization by name or channel handle.

Get a single contact by id, including its segments and properties.

Update a contact: name, blocked, unsubscribed or AI-replies flags.

Permanently delete a contact and its conversations.

Merge duplicate contacts into a primary contact.

Add or remove segments on a contact.

Read the activity timeline of a contact, newest first: profile changes, segment changes, blocks, unsubscribes, comments and file uploads, with who did each.

Read the internal team comments on a contact, newest first. Comments are notes for the team; the contact never sees them.

Add an internal team comment to a contact, authored as the current user. The contact never sees it.

Read what the assistants remember about a contact (preferences, facts, context picked up in conversations), sorted by importance.

List the files of a contact: attachments exchanged in conversations and direct uploads, with download URLs.

List the org's suppression list — emails and phone numbers that broadcasts and outbound sends skip (bounces, complaints, unsubscribes, manual blocks). Use it to explain why a recipient was skipped.

Add emails or phone numbers to the suppression list so broadcasts and outbound sends skip them, one or many per call. Each entry is validated; dry_run previews created/skipped/invalid without writing.

Remove emails or phone numbers from the suppression list so they can receive broadcasts and outbound sends again.

Bulk-create or update contacts from structured rows (e.g. a parsed CSV): each entry becomes a contact channel with optional name and properties, deduped and validated against existing contacts. dry_run previews created/updated/invalid without writing.