Skip to main content

Mailing Lists Overview

What it is​

A mailing list is a collection of recipient records - names, addresses, and optional contact details - that you use to drive mail orders. Every send on thanks.io targets one or more mailing lists, whether you are placing a one-off batch or running an automated campaign.

Lists are the connective tissue of the platform. Campaigns attach to lists. QR scan automations move people between lists. Analytics track engagement per list. A well-organized set of lists gives you precise control over who gets what mail and when.

The Mailing Lists page​

Open Mailing Lists under Audience in the sidebar. Every list shows its name, its kind (for example "System list" or "Suppression list"), when it was added, and how many recipients it holds. System lists, such as All QR Scans and the list your Neighbor Blast campaigns fill, are pinned to the top and filled automatically; you can't rename, delete, or add to them. Suppression lists are shown in red. A list that a Done For You program set up shows a Set up by label with the program's name, such as Set up by MailMatch; it's still an ordinary list you can edit, add to, or delete.

Use Search lists to find a list by name or type, and the sort menu to order them by Newest, Latest added, or A-Z. The folder chips above them show one folder at a time (see Organizing lists into folders).

Creating a list​

  1. Open Mailing Lists in the sidebar.
  2. Click Add Mailing List.
  3. Enter a List name (e.g., "Q3 New Leads" or "Just Listed Farm - Oak Park").
  4. Click Create list.

The new list opens, ready for recipients. While a sub-account is active, the list is created in that sub-account.

Before you have any lists, the Mailing Lists page offers Add recipients directly; that dialog names a new list as part of adding its first recipients.

Adding recipients​

Open a list and click Add recipients to open the Add Recipients dialog. Each option opens a guided setup:

OptionWhat it does
Lead Feed (Recommended)Find consumers or businesses showing intent for your product or service, and add them once or on a daily or weekly feed. 10 cents per new lead. See Lead Feeds.
Upload Mailing or Email CSVImport recipients in bulk from a .csv, .xlsx or .xls file: match your columns, verify the data, then import. See CSV Upload & Format.
Manually Enter AddressAdd one recipient at a time with full mailing details. Keep adding, then click Done.
Manually Enter Email AddressLook up a person's mailing address from their email address and add them. This is a paid lookup.
Radius SearchBuy the addresses nearest to one you choose. See Radius Search.
Connect an AppAdd people automatically as they come in from Zapier, HubSpot, HighLevel, Make, or a webhook. Links to Integrations & API and to the list's add-to-list webhook.

Recipients can also arrive from outside the dashboard:

  • API - add recipients programmatically using the thanks.io REST API. See docs.thanks.io for the full endpoint reference.
  • Zapier - use the thanks.io Zapier integration to add recipients from any connected app (e.g., CRM, form builder, or spreadsheet) without writing code.
  • Add-to-List Webhook - every list has its own webhook URL that a CRM workflow can fire to add a contact. See Add-to-List Webhooks.
  • HubSpot - add a contact or company to a list from the record's sidebar in HubSpot (see HubSpot Integration), or add every record a HubSpot workflow enrolls with the Add to Mailing List workflow action (see Add records to a mailing list from a HubSpot workflow).
  • Address collection landing page - a hosted form people fill in themselves. See Address Collection Landing Pages.
  • Campaign automation - campaigns can move recipients between lists automatically on send or scan events.

Existing rows can also gain contact details on their own: when your account requires contact info to redeem gift cards, the email address or phone number a recipient enters to claim their card is written back to the list the card was mailed from. It fills blank fields only, matches on mailing address, and never overwrites an email or phone already on the row. See Gift Card Redemption Contact Info.

Working with a list​

The list page shows the list's kind, recipient count, date added, and its ID (# followed by a number). A list that has a lead feed also shows a Lead feed card with its status and Pause, Resume, and Stop buttons. Use the Rename list button next to the name to rename it; campaigns and sends that use it keep working.

  • Send to this list opens Send Mail with the list already chosen as the recipients.
  • The ⋮ menu has Campaign actions (the list's campaign page), View orders (Orders filtered to this list), Move to folder (see Organizing lists into folders), Append entire list, the exports (see Exporting Lists), and Delete list. While a search or the Undeliverable only filter is active, the menu also offers Append filtered recipients, which searches phone & email for just the recipients matching the filter (on every page of results), and the whole-list option is labeled Append entire list (ignores filters).

Searching and filtering recipients​

Use Search name or address to find recipients, and sort by newest, oldest, name, upcoming birthday or anniversary, city, state, or Undeliverable first. Switch on Undeliverable only to surface addresses that failed verification and need attention. An undeliverable address shows a warning with the reason.

Click any row to edit the recipient. For an undeliverable address, the edit dialog explains why and offers Mark deliverable if you know the address is good. Each row's menu also has Search phone & email, Send to this person, Search everywhere (opens Recipient Search for that name), and Remove from list.

Select recipients with the checkboxes (across pages if you need to) to Send to selected, Search phone & email for just those recipients (a paid lookup), Move them to another list, or Delete them. See Moving Contacts Between Lists.

Choosing which columns show​

Every row shows the recipient's Name and Address. Use the Columns button in the recipients toolbar to choose which other columns appear beside them:

  • Contact - icons showing whether the recipient has an email address and phone number on file.
  • Email and Phone - the email address and phone number themselves.
  • Added - the date the recipient joined the list.
  • Dates - the recipient's birthday and anniversary.
  • Custom 1 - Custom 10, under Custom fields - the values stored in each custom field, such as the ones you mapped during a CSV upload.

By default the table shows Contact, Added, and Dates. Tick or untick as many columns as you like; the menu stays open until you click away. Reset to default puts back the default set.

Your choice applies to every mailing list and is remembered in the browser you made it in. Another browser or device starts from the default columns. On a phone or other narrow screen, the optional columns are hidden so that Name and Address stay readable.

Advanced settings​

A list's tracking URL, QR scan actions, suppression setting, address collection landing page, retargeting code, and add-to-list webhook are on its List settings page. Open it with the Advanced settings button at the top of the list's page, or the Advanced settings link under the recipients. These settings are part of the Business plan.

Organizing lists into folders​

Folders group lists you work with together, such as one client's lists or one neighborhood's. A list sits in one folder at a time, or in none.

Mailing lists and campaigns share their folders, because a campaign is its mailing list plus the actions that mail it. Filing a list in a folder files its campaign there too, and filing a campaign files its list. The same folders appear on both the Mailing Lists and Campaigns pages. Creatives have their own, separate folders (see Organize creatives into folders).

Create a folder​

  1. On Mailing Lists (or Campaigns), click New folder above the list.
  2. Enter a Folder name of up to 60 characters. Each folder needs a name you haven't used for another list folder.
  3. Optionally pick an Emoji. It shows in place of the folder icon wherever the folder appears. To leave it off, pick the plain folder icon (No emoji).
  4. Click Create folder. The new folder opens.

You can also create a folder while filing a list: choose Move to folder → New folder…, and the list goes straight into the folder you create.

Move a list into a folder​

  • From the Mailing Lists page - click the ⋮ button at the end of the list's row, choose Move to folder, then the folder.
  • From the list's page - open the ⋮ menu next to the list's name and choose Move to folder.

The list moves as soon as you pick the folder, and its campaign moves with it. To take it out of its folder, choose Move to folder → Remove from folder. While All is selected, each row shows the name of the folder the list is in.

Browse a folder​

Once you have a folder, the chips above your lists show All, then each folder with the number of lists in it. Click a folder's chip to show only the lists in it; Search lists still works inside it. Click All to see every list again.

The page remembers the folder you last had open in this browser, separately for each sub-account, and opens on it the next time you visit. Mailing Lists and Campaigns each remember their own, so the two pages can be open on different folders.

Rename, change the emoji, or delete a folder​

Click a folder's chip to open it, then click the ... button on the chip:

  • Edit folder - change the Folder name or Emoji, then click Save. Everything in it stays where it is.
  • Delete folder - confirm with Delete folder. Only the folder is deleted: the lists and campaigns in it are kept, and show under All on both pages.

Folder limits​

  • Up to 50 list folders per account, and another 50 in each sub-account. Each sub-account has its own folders, and a list can only go into a folder of the sub-account it belongs to.
  • Folder names can be up to 60 characters, and no two list folders can share a name.
  • The Deleted lists section isn't filtered by folder. See Deleting and Restoring Lists.

Some ways of adding to or enriching a list use a pay-per-use data service:

LookupWhereFee
Buy intent-based leadsLead Feed, once or as a daily or weekly feed10¢ per new lead added (people already on the list are skipped and not charged)
Find a mailing address from an emailManually Enter Email Address, or Find mailing addresses from emails on a CSV upload7¢ per address found
Search phone & email for one recipientThe recipient's row menu → Search phone & email20¢ per lookup (some matches take two)
Search phone & email for a whole listThe list's ⋮ menu → Append entire list20¢ per match, for every recipient not yet searched
Search phone & email for part of a listAppend filtered recipients in the ⋮ menu (while a filter is active), or select rows and click Search phone & email20¢ per match, for every recipient in that scope not yet searched
Search phone & email on importSearch phone & email for every row on a CSV upload20¢ per lookup (some matches take two)

A lookup only runs when you choose it. Each one asks you to confirm with its fee first (the whole-list search states the most it can cost), and a CSV upload runs a lookup only if you tick it. Paid lookups need a card on file and a credit balance that isn't negative; otherwise the option explains why and links to Settings → Payment Method. See Data Services.

Recipient Search, under Audience in the sidebar, searches every one of your mailing lists and your sent mail at once. Type at least three characters of a name or address. Results come in two tables: recipients on your lists (with the mailing list each is on) and the pieces you have sent (with the order, status, scans, and a PDF proof where one is available). Click a list or an order to open it. Each table shows up to the 25 most recent matches. A recipient's menu lets you Edit them, or Mark deliverable an undeliverable address, right from the results. While a sub-account is active, the search covers that sub-account only.

Deleting and restoring a list​

Delete a list from its ⋮ menu → Delete list. Deleted lists are set aside rather than erased: switch on Show deleted lists on the Mailing Lists page to see them and Restore one with a single click. Restoring a list brings its recipients back too.

Automated campaigns that were bound to the list are removed when the list is deleted, and they stay deleted when the list is restored. Recreate any campaigns you still want under Campaigns. Full walkthrough: Deleting and Restoring Lists.

Tips & best practices​

  • Name lists by purpose and date so they stay organized (e.g., "Birthday Campaign 2026").
  • File related lists in a folder, such as one per client or farm area, so their campaigns are grouped the same way.
  • Keep separate lists for different campaign types - don't mix drip recipients with birthday recipients.
  • Use the Undeliverable only switch regularly before sending.
  • Use Move Recipient on Send or Move Recipient on Scan to build engagement-based segments automatically.

Plan-based limits​

  • List management is available on all tiers, including Free.