Contacts and lists
Add contacts by API or CSV import (up to 250,000 rows), group them into lists, store custom properties and locations.
Contacts are the people you email. Each has an email address, an optional first and last name, any custom properties you like, and a status. Lists group contacts so you can send a campaign to them. There's no charge for contacts.
Add contacts#
Add [email protected] (Ada Lovelace, plan Pro, company Analytical Engines) to my Customers list.
Put these people on a new list called Beta: [email protected], [email protected], [email protected].
Which lists do I have and how big is each?
Lists you name are created if they don't exist yet. From your app, use the API when someone signs up.
Properties are merged with what's already stored and can be used in emails as variables. Sending the sign-up ip turns on the IP contact checks and fills in the contact's country and timezone.
Import a CSV#
Under Contacts → Import CSV, upload a file with a header row. Up to 25 MB and 250,000 rows per file.
| Column | Accepted headers |
|---|---|
| Email (required) | email, email_address, e_mail, mail |
| First name | first_name, firstname, first, given_name |
| Last name | last_name, lastname, last, surname, family_name |
| Full name | name, full_name (split into first and last) |
| Anything else | Saved as a custom property with the column name. |
Invalid addresses, duplicates in the file, and role addresses like noreply@ or abuse@ are skipped and counted.
Statuses#
- Subscribed: gets campaigns.
- Unsubscribed: clicked unsubscribe. Gets transactional email, not campaigns.
- Bounced and Complained: never emailed again.
Search and filter#
The Contacts page searches by email or name and filters by status, list, country and contact-check result, 50 to 200 rows a page.
Locations
Maillayer fills in each contact's country, region, city and timezone from their sign-up IP, or from where they first click or open an email. You can also set country and timezone yourself through the API; those always win. Locations power the country filter and the "opens by local time" chart in campaign results.
See the Contacts API and Lists API.