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 one or many contacts and their conversations, in one call (up to 1,000).

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.

Add an internal team comment to a contact.

Change the text of a contact comment you wrote; files stay attached.

Delete an internal team comment from a contact.

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).

Add emails or phone numbers to the suppression list so broadcasts and outbound sends skip them, one or many per call.

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.

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.

Triggers when a new contact arrives or is added

Triggers when a field of a contact changes

Triggers when a contact joins a segment

Triggers when a contact leaves a segment

Triggers when a contact is blocked

Triggers when a contact unsubscribes