Contacts

Search contacts in this organization by name or channel handle.

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

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. The contact never sees it. Signed by the member, or by the agent or assistant that writes it.

Change the text of a contact comment you wrote; files stay attached. Only the author can edit. A comment linked to a conversation note also updates the note.

Delete an internal team comment from a contact. This cannot be undone.

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 fields, deduped and validated against existing contacts. dry_run previews created/updated/invalid without writing.

List the custom contact fields (the properties every contact carries), with their type and options.

Create and/or update custom contact fields (the properties every contact carries), one or many per call.

Permanently delete a custom contact field and its values on every contact. Irreversible; archive the field instead to hide it.