> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usertick.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Usertick runs surveys on websites, by link, by QR code and by email, and collects every response in one inbox with reports, dashboards and workflows. The REST API lives at https://app.usertick.com/api/public/v1 and uses Bearer API keys or OAuth access tokens; the JavaScript SDK is the @usertick/snippet package on npm.

# Contacts and lists

> Add people one by one or from a CSV file, group them in lists, see each contact's emails and answers, and handle unsubscribes and deletions.

Everyone you can send survey emails to is listed in **Email → Contacts**. Your lists appear under it in the menu on the left, each with its icon and the number of people on it, and selecting a list shows those people.

![Email → Contacts with a list and its count in the menu, the contacts table with Email, Name, Lists, Status and Added, Import CSV and Add contact](https://mintcdn.com/usertick/b7hHAD5bKMN_XhRp/images/email-contacts.png?fit=max\&auto=format\&n=b7hHAD5bKMN_XhRp\&q=85\&s=b82938073d55d8f2c024a30757dfae0d)

Email → Contacts

## Find a contact

The table lists each contact under the columns **Email**, **Name**, **Lists**, **Status** and **Added**.

* Search finds contacts by their email address or name.
* **Filters** narrows the table by **List**, by **Status** (**Subscribed** or **Unsubscribed**) and by **Added** (**Last 7 days**, **Last 30 days** or **Last 90 days**).
* **Sort** puts the contacts in order by **Date added**, **Name** or **Email**.

The search box also accepts `list:Customers`, `is:subscribed`, `is:unsubscribed` and `added:7d`, `added:30d` or `added:90d`. Put a list name that contains spaces in quotes, and press <kbd>Enter</kbd> to apply the filters.

## Add a contact

1. Select **Add contact**.
2. Enter the person's **Email** and, optionally, their **Name**.
3. Under **Lists**, add the lists the person belongs on. If you started from an open list, that list is already selected.
4. Under **Details**, select **Add field** to add extra fields that emails can insert, such as company or plan.
5. Select **Save**, or **Save and add another** to keep the form open for the next person.

## Import contacts from a CSV file

Select **Import CSV** and choose a file with one address per line, optionally followed by a name, in the form `email,name`. If a list is open, Usertick also adds the people to that list.

You can import a file of any length. A message shows the progress as the rows come in, and at the end it says how many people were added, how many were already in your contacts, how many addresses weren't valid and how many were repeated in the file. If an import stops partway, the people added so far are kept, and when you import the same file again, Usertick skips the addresses already in your contacts.

## Manage lists

* To create a **New list**, select **+** beside **Lists**, then enter a name and choose an icon. One person can be on many lists.
* **Edit list** in a list's **…** menu changes its name or icon.
* **Send a survey to this list**, in the same menu, opens [New send](https://docs.usertick.com/email/send.md) with the list already in **To**.
* **Delete list**, also in that menu, asks you to type the list's name to confirm. The people stay in your contacts, and past sends keep the list name. A scheduled send to the list stops when its time comes, so nobody receives it.

On a small screen, you create a new list from the menu beside the page title, and **Filters** → **List** shows the people on a list.

## Change several contacts at once

After you select contacts in the table, you can act on all of them at once:

* **Add to list** adds them to the list you choose. To put them on a new list, type its name and select **Create list**.
* **Remove from** takes them off the list that is open.
* **Delete** removes them after you confirm by typing `delete` and the number of contacts.

## Open a contact

Select a contact to open their panel.

![A contact's panel with Edit, Status, External ID, Lists with Add to list, Emails, Answers with Open in Inbox, and Unsubscribe](https://mintcdn.com/usertick/b7hHAD5bKMN_XhRp/images/email-contact-panel.png?fit=max\&auto=format\&n=b7hHAD5bKMN_XhRp\&q=85\&s=be89834e2eec1799f203aa6e566256d9)

A contact's panel

* **Status** reads **Subscribed**, or **Unsubscribed** with the date.
* **External ID** holds your own user ID for this person, and verified responses from your site that carry this ID link to the contact. See [How a response links to a contact](https://docs.usertick.com/installation/identify.md#how-a-response-links-to-a-contact).
* **Source** appears when a verified sign-in on your site or a HubSpot workflow created the contact.
* **Lists** lets you add the person to a list with **Add to list**, or to a new list by typing its name and selecting **Create list**, and remove a list with its **×**.
* **Emails** lists every survey email sent to the person with its result, and selecting one opens the send.
* **Answers** collects the person's responses, each with the reason it is linked to them, such as **Responded to a survey email** or **Matched by user ID**. **Open in Inbox** opens the response.

**Edit** lets you change the name and **External ID**, and Usertick saves the changes when you select **Save**.

## Unsubscribes

Every survey email includes an unsubscribe link, which opens a page where the person confirms with **Unsubscribe**. When a mail app shows its own unsubscribe button, that button unsubscribes the person directly. To unsubscribe someone yourself, select **Unsubscribe** in their panel. You can't undo this.

Every later send skips an unsubscribed contact, and marking an email as spam has the same effect. The unsubscribe also outlasts the contact, so if you delete the person and later add or import the address again, it comes back as **Unsubscribed**.

## Delete a contact

To delete a contact, select the delete icon in their panel and type the email address to confirm. The contact is removed from every list, and their address is removed from your sends' recipient logs, where they appear as **Deleted contact** while each send keeps its counts. Their responses are kept. To remove a person together with their responses, erase the contact through the [REST API](https://docs.usertick.com/developers/api/erasure.md#erase-a-contact).

## Who can do this

Seeing contacts and lists requires the **View surveys and results** permission. Adding, importing, editing, unsubscribing and deleting contacts, as well as creating, editing and deleting lists, requires **Manage contacts**. No plan limits the number of contacts. To manage contacts from your own code, see the [Contacts API](https://docs.usertick.com/developers/api/contacts.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.