Manage Contacts and Segments

Last updated 5 days ago

This guide covers how to work with your contact list and segments once they have been set up. You will learn how to customize your contact table view, filter contacts, take quick actions on individual contacts, archive and restore contacts, and manage your segments from the Segments dashboard.

Before you start

The steps in this guide work best when the following are in place:

  • At least one contact exists in the system. See the Create a Contact Guide for step-by-step instructions to add contacts.

  • At least one segment exists to follow the segment management steps.See the Create a Segment Guide for step-by-step instructions to create your first segment.

The contacts page

To open your contact list, navigate to Contacts in the left sidebar. The page shows two tabs at the top: Active displays your current contacts, and Archived displays contacts you have moved off the active list. The main area shows the contact list table.

Understand the contact list table

The contact list table displays all your contacts with their information organized in columns. You can customize which columns appear to focus on the information most relevant to you.

To customize your table columns:

  1. Click the Columns button at the top right of the table.

  2. Toggle columns on or off. The columns available are:

    Column

    Description

    Name

    Contact's full name

    Mobile Number

    Contact's phone number

    Teams

    Teams assigned to the contact

    Email Enabled

    Contact’s email communication preference status (enabled, disabled, or blocked)

    SMS Enabled

    Contact’s SMS communication preference status (enabled, disabled, or blocked)

    Tags

    Tags applied to the contact record

    Created Date

    Date the contact was added to the system

    Updated Date

    Date the contact record was last modified

    Contact Form Responses

    Answers submitted through contact forms

💡 Keep your table uncluttered by displaying only the columns you use regularly. You can always add more columns when needed.

Filter contacts

You can filter your contact list to find specific contacts or groups of contacts that match certain criteria.

To filter contacts:

  1. Navigate to Contacts in the left sidebar.

  2. To search by name or email, enter the contact's name or email address in the search bar at the top of the table.

  3. To filter by conditions, click the funnel icon to the left of the search bar. The filter panel opens. The available filter conditions are:

    Filter

    Description

    Teams

    Filters contacts by their assigned team

    Email Enabled

    Filters by email status: enabled, disabled, or blocked

    SMS Enabled

    Filters by SMS status: enabled, disabled, or blocked

    Tags

    Filters by tags applied to the contact record

    Mobile Number

    Filters by numbers that start with or match a specific value

    Contact Form Responses

    Filters based on answers provided in contact forms

  4. To save your filtered results as a segment, click Save as Segment at the top right corner of the table after applying your filters. You will be redirected to the Segments dashboard to enter a name and description for the new segment.

✏️ Saving a filtered view as a segment creates a dynamic group. Contacts enter or leave the segment automatically as their records change to meet or stop meeting the conditions you set.

Quick contact actions

You can take action on individual contacts directly from the contact list without opening each contact record.

To access quick actions for a contact:

  1. Locate the contact in the table.

  2. Click the three vertical dots (⋮) under the Actions column.

  3. Select an action from the menu. The actions available are:

    Action

    Description

    Manage Contact

    Opens the full contact record to view and edit details, review the Activity Log, and upload documents

    Trigger Workflow

    Runs a workflow for this contact, such as sending a form or an SMS message

    View Conversations

    Opens the contact's full message history

    Create Note

    Adds a note to the contact record

    Grant Portal Access

    Gives the contact access to the patient portal

    Refer to Provider

    Sends a referral to connected providers with optional notes or file attachments

    Assign Team

    Assigns the contact to a specific team

    Archive Contact

    Moves the contact to the archived contacts list

⚠️ When triggering event-based workflows manually, the workflow may fail if it depends on event data that will not be available. Proceed with caution when you see this warning in the platform.

Archive and restore contacts

Archiving removes a contact from your active list without deleting them permanently. You can restore an archived contact at any time.

Archive a contact

To archive a contact:

  1. Click the three vertical dots (⋮) under the Actions column for the contact you want to archive.

  2. Select Archive Contact from the dropdown menu.

  3. In the confirmation popup, click Continue to archive the contact, or click Cancel to stop.

✏️ Archived contacts move to the Archived tab at the top of the contacts page and can be restored at any time.

Restore an archived contact

To restore an archived contact:

  1. Click the Archived tab at the top of the contacts page.

  2. Locate the contact in the archived list.

  3. Click the three vertical dots (⋮) under the Actions column.

  4. Select Restore Contact.

The contact returns to your active contact list immediately.

Manage segments

Segments help you organize contacts into groups based on shared characteristics or behaviors. For detailed instructions on creating a new segment, see the Create a Segment Guide.

To open the Segments dashboard, navigate to Contacts in the left sidebar, then select Segments.

Filter the segment list

As your segment list grows, locating a specific segment by scrolling becomes time-consuming. The search bar at the top of the Segments dashboard lets you search by segment name so you can go directly to the segment you need without scanning the entire list.

Show or hide segment table columns

The Segments dashboard displays a default set of columns, but you may not need all of them at once. Clicking the Columns button lets you choose exactly what information appears on screen, so you can keep the table focused on what matters to you.

To customize the segment table columns:

  1. Click the Columns button at the top right of the table.

  2. Toggle columns on or off. The columns available are:

    Column

    Description

    Name

    The segment's name.

    Members

    The number of contacts currently in the segment. Click the number to open the segment and view each member's name and details.

    Conditions

    The conditions that determine which contacts belong to the segment. Click the number to open a summary of the segment's conditions.

    Created Date

    The date the segment was created.

    Updated Date

    The date the segment was last modified.

    Deleted Date

    The date the segment was deleted.

Hiding columns you do not regularly use keeps the table easy to scan and reduces visual clutter.

Quick segment actions

You can take action on individual segments directly from the Segments dashboard without opening each segment.

To access quick actions for a segment:

  1. Locate the segment in the table.

  2. Click the three dots (⋮) under the Actions column.

  3. Select an action from the menu. The actions available are:

    Action

    Description

    View Members

    Shows all contacts currently in the segment

    Edit Segment

    Opens the segment to modify its name, description, or conditions

    Create Broadcast

    Starts a new broadcast addressed to all contacts in the segment

    Duplicate Segment

    Creates a copy of the segment with the same conditions

    Archive Segment

    Moves the segment to the archived list

💡 Use the duplicate function to create similar segments without building from scratch. Duplicate an existing segment and adjust the conditions rather than setting up a new one from the beginning.

Related articles

Now that you know how to manage contacts and segments, check these related articles to make the most out of this feature.

  • Create an SMS broadcast: Learn how to use a segment as the recipient list for a one-to-many SMS message sent to multiple contacts at once.

  • Contacts in Subflow: Understand what a contact record contains and how contact data connects to segments, workflows, and messaging.