Individual Contacts

Manage individual contacts, add new ones, edit details, and apply filters to search for specific contacts.

This code has a syntax error that's common when mixing Markdown and HTML. The issue is in your table, specifically in the "Additional Actions" row.

You've used Markdown's image syntax (![](...)) inside an HTML <td> tag. The MDX parser cannot correctly process Markdown syntax inside a raw HTML table block.

🛠️ The Fix

You must replace the Markdown image syntax with a standard HTML <img> tag. I have also made sure the URL is correctly formatted (removing the unnecessary \ backslashes) and made the tag self-closing (/>).

Here is the fully corrected code:

<HTMLBlock>{`
<div style="text-align: right; font-style: italic;">
<a href="https://docs.commpeak.com/docs/contact-management">Contacts</a> > 
Individual Contacts
</div>
`}</HTMLBlock>

To manage details in your <Glossary>contact list</Glossary>s, log in to [TextPeak](https://textpeak.commpeak.com/) in your browser and select the **Individual Contacts** tab under **Contacts** in the main menu.

<Image alt="Screenshot of the **Individual Contacts** page" align="center" border={true} src="https://files.readme.io/b1b8e39acfd0d66d4a170bbada0fafd5d0355042335098ddeed0f9361699bbe3-Individual_Contacts.png">
  **Individual Contacts** page
</Image>

The total number of contacts is shown above the table with contact details. If you apply search filters, the total number corresponds to the filtered contacts.

On the **Individual Contacts** page, you can:

* add new contacts
* edit individual contacts
* download contact details as a *.csv* file
* view messages sent to individual contacts
* opt-out or delete selected contact details
* apply filters to search for individual contacts; for example, to display all contacts that clicked on <Glossary>Short URL</Glossary> or <Glossary>Opt-out URL</Glossary> in specific campaigns, or sort out the campaigns using the **Created At**, **Phone**, **Contact List**, **Parse Status**, **Country**, **Operator**, and **Clicked On** drop-down lists.

<Image alt="Screenshot of the search filters" align="center" border={true} src="https://files.readme.io/5ab0e04bce122954a2f0bcb23d03444f2c2b5eb051d394c35516d0518f433697-Individual_Contacts_filter.png">
  Applying search filters
</Image>

The **Individual Contacts** table contains the following columns.

<Table>
  <thead>
    <tr>
      <th>
        Column
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Checkbox
      </td>

      <td>
        Select a checkbox in the header to select all contacts. Otherwise, choose individual records.
      </td>
    </tr>

    <tr>
      <td>
        Parse Status
      </td>

      <td>
        The status the system assigns to the contact while adding it:  

        * *OK* - no issues with contact data, and the contact will participate in campaigns (receive SMS messages)
        * *INVALID* - the system found an issue with contact data, and it won't participate in campaigns
        * *NOT MOBILE* - the phone number is not mobile
        * *BLACKLIST* - the contact is opted-out
        * *DUPLICATE* - the contact with the same phone number already exists
      </td>
    </tr>

    <tr>
      <td>
        First Name
      </td>

      <td>
        Contact first name. Click it to open the sidebar with contact information.
      </td>
    </tr>

    <tr>
      <td>
        Last Name
      </td>

      <td>
        Contact last name
      </td>
    </tr>

    <tr>
      <td>
        Phone
      </td>

      <td>
        Phone number
      </td>
    </tr>

    <tr>
      <td>
        Country
      </td>

      <td>
        Contact country
      </td>
    </tr>

    <tr>
      <td>
        Operator
      </td>

      <td>
        Contact operator defined by the prefix (not <Glossary>HLR</Glossary>)
      </td>
    </tr>

    <tr>
      <td>
        <Standard Field>
      </td>

      <td>
        If you enable standard fields other than phone, the columns with standard details will appear in the table. These fields are optional; that is why the details can be empty.
      </td>
    </tr>

    <tr>
      <td>
        Custom Fields
      </td>

      <td>
        Hover over the number of existing custom fields ([additional details](contact-fields)) for more information
      </td>
    </tr>

    <tr>
      <td>
        Created At
      </td>

      <td>
        Date and time in UTC when the contact was added
      </td>
    </tr>

    <tr>
      <td>
        Additional Actions <img src="https://commpeak-b240aad99740.intercom-attachments-1.com/i/o/777325861/f2295189c5ab31d7ffaf488a/1655296785344-1655296785344.png?expires=1725192900&signature=9db496255cd9266e427a1fdd04f1141df711377f446494fb65dd0558f022c14e&req=cycgFct7lYdeFb4f3HP0gIa1Hz8DlCgXiiNYphjMnNpE6B5yiUP4O2xOYMG4%0AClc%B%0A" alt="Additional actions icon" style="display: inline-block; vertical-align: middle; height: 1em;" />
      </td>

      <td>
        Click the three-dot menu on the right to apply the following actions to an individual contact:  

        * click **Export** to download individual contact as a *.csv* file
        * click **View messages** to view sent SMS messages, their campaign names, and timestamps
        * click **Edit** to modify individual contact details and save
        * click **Opt out**to opt-out the individual contact from all campaigns, then confirm
        * click **Delete** to remove the individual contact, then confirm.
      </td>
    </tr>
  </tbody>
</Table>

# Adding New Contacts

**To add a new contact to an existing<Glossary>contact list</Glossary>** :

1.  Log in to [TextPeak](https://textpeak.commpeak.com/) in your browser.
2.  Open the **Contacts > Individual Contacts** tab.
3.  Click **Add Contact** in the top right.
4.  In **List Details**, select an existing list:

   <Image alt="Screenshot of the **Add New Contact** section" align="center" src="https://files.readme.io/bb043eb2e5100688ff80e94c06a43dc7bac9a4b55ccc478bfb0bcb5b81bc4824-image.png">
     **Add New Contact** section
   </Image>
5.  Enter standard and additional contact details. The system will populate the **Country** and **Operator** fields based on the phone number. Mandatory fields are marked with \*.
6.  Then click **Save And Next**.

s<Image alt="Screenshot of the **Contact Details** section" align="center" width="600px" border={true} src="https://files.readme.io/c3a3c9f1d0bebb6a00ec37440a0d7ce148dfae7e106267f1ee71d6280b3eafce-Screenshot_2025-04-25_183539.png">
     **Contact Details** section
   </Image>

> 📘 NOTE
>
> You can enable and disable standard details or create additional ones in the **Contact Details** settings.

The newly added contact will appear at the top of the **Individual Contacts**table.

# Managing Your Contacts

To manage a single contact, use the three-dot menu on the right.

To manage multiple contacts, select them using the checkboxes on the left. Choosing more than one record enables controls for managing multiple contact details:

<Image alt="Screenshot of the contact management controls" align="center" border={true} src="https://files.readme.io/1f558237ce70f069d598790248d96a4f481707a299fd12bc95c4a15535e6cb4a-Individual_Contacts_opt.png">
  Contact management controls
</Image>

* click **Opt-out** or **Delete selected** above the table to opt-out multiple contacts from all campaigns or remove them from the platform
* click **Export selected** to download selected contacts as a *.csv* file.

To view the contact information, click the contact name. 

<Image align="center" className="border" border={true} src="https://files.readme.io/32ccef645461575e24f7a66a9913703ec7db8436135bb76266a0deba594965ef-Click_Contact.png" />

To edit the contact data, click the edit icon, make changes, and click **Save**.

<Image alt="Screenshot of editing contact info" align="center" width="500px" border={true} src="https://files.readme.io/185f7cf65252d93d0be150109773e658fa1d54ab14382cd5028a4d46410ae9b6-Edit_contact.png">
  Editing contact info
</Image>