Adding and importing contacts

Your contacts are the heart of BlueyEmail. This guide covers the everyday ways to add people to your audience, how to store extra details with custom fields, and what happens when a contact bounces or unsubscribes.

Contacts live under Contacts in the left-hand navigation, in the *audience* group. The All contacts sub-tab is your master list, and everything you import, collect, or add by hand lands there first.

Ways to add contacts

There are four ways to get people into your audience. Most teams use a mix of all of them.

• CSV upload — the go-to for adding many contacts at once. Export a spreadsheet from another tool as a .csv file, then upload it and match your columns to BlueyEmail fields.
• Paste a list — quick for a handful of addresses. Paste them straight into the import box, one email per line.
• Add Lead — add a single contact and fill in their details by hand. Handy when someone signs up in person or over the phone.
• Forms and API — new contacts flow in automatically whenever someone completes one of your forms, or when your website or app sends them through the API. This is the best way to keep your list growing on autopilot.

The one required field: email

Email address is the only column BlueyEmail truly needs — it's how we identify each person and send to them. Everything else (first name, last name, company, and so on) is optional but makes your emails feel more personal.

When you upload a CSV, you'll map each spreadsheet column to a BlueyEmail field. Make sure the column holding email addresses is mapped to Email, and you're good to go.

Custom fields for your own data

Beyond the standard fields, you can create custom fields to store whatever matters to your business — plan type, city, birthday, favorite product, account ID, and so on. Custom fields power personalization and give you more precise ways to build segments.

1. 1

   Open a contact or the import mapping screen

   Custom fields can be created while mapping a CSV or from an individual contact record.

2. 2

   Choose "Add a custom field"

   Give it a clear name like "Plan" or "Signup source".

3. 3

   Pick the field type

   Text, number, or date — pick what fits the data so filters behave correctly later.

4. 4

   Map or fill in the value

   During import, match your spreadsheet column to the new field. For a single contact, just type the value.

Duplicates are merged automatically

If you import someone who's already in your audience, BlueyEmail won't create a second record. Instead it upserts — it updates the existing contact with any new details, and any tags in the import are merged onto the contact rather than replacing what's already there.

• New or changed field values overwrite the old ones, so your most recent import wins for those fields.
• Tags are added, not swapped — a contact keeps every tag they had plus the new ones.
• The contact is matched by email address, so keep that column clean and consistent.

Contact statuses

Every contact carries a status that tells you whether you can email them. It updates automatically as people engage (or disengage) with your campaigns.

• Active — a healthy, subscribed contact. These people receive your campaigns.
• Unsubscribed — they opted out. BlueyEmail stops emailing them automatically, and you should never try to re-add them without a fresh opt-in.
• Bounced — the address rejected your mail (for example, it doesn't exist). Bounced contacts are suppressed so you protect your sender reputation.