Skip to main content
Your Audience is the database of people you send marketing email to from Lettr. It lives separately from your transactional sending: transactional emails go to recipients you specify per API call, while campaigns go to people you’ve already collected in your Audience. The Audience is a single, team-wide pool of contacts. You don’t create multiple audiences — instead, you organize one pool using lists, topics, and segments, then point campaigns at whichever slice of the pool you want to reach.
The entire audience pool, including its lists and segments, can also be managed programmatically. See the Audience API to read and modify contacts, lists, topics, properties, and segments from your own application.
The Audience feature is part of Lettr’s marketing plan. Every account includes a free 500-contact tier; larger audiences require a paid marketing tier. See Billing for tiers and pricing.

​
Core Concepts

The Audience feature is built around five entities. Understanding how they relate is the fastest way to get productive.
ConceptWhat it is
ContactOne person in your audience, identified by email address. Has a status (subscribed, unsubscribed, bounced, complained, unverified) and any custom properties you choose to attach.
PropertyA named field you define once for your whole team (for example first_name, plan, signed_up_at). Every contact can have its own value for each property.
ListA static, named group of contacts. You add and remove contacts yourself. A contact can belong to many lists.
TopicA subscription category contacts can opt in or out of (for example “Product Updates” or “Weekly Digest”). Lets recipients manage preferences at a finer grain than a single subscribe/unsubscribe toggle.
SegmentA dynamic group defined by conditions (for example “subscribed contacts with plan = pro who signed up after January”). Segments re-evaluate themselves whenever contact data changes.

Contacts

The individual records that make up your audience — statuses, properties, and the activity log

Lists

Static groups for organizing contacts by purpose

Topics

Subscription preferences contacts can opt in and out of

Segments

Dynamic groups defined by conditions, with an AI segment builder

Importing & Exporting

Bulk-load contacts from CSV and export your audience

Double Opt-In

Confirm new signups before they enter your audience

​
How Audience and Campaigns Connect

The Audience feature gives you the people. The Campaigns feature gives you the way to email them. When you build a campaign, you choose its audience by selecting one of three options:
  1. All contacts — every subscribed contact in your team
  2. One or more lists — contacts who are members of any of the selected lists
  3. One or more segments — contacts matching the conditions of any of the selected segments
You can combine lists and segments in the same campaign. Contacts that appear in more than one source are sent the email exactly once.
Campaigns only send to contacts whose status is subscribed. Contacts marked unsubscribed, bounced, complained, or unverified are skipped automatically. You don’t have to manage suppression yourself.

​
Getting Started

1

Define your custom properties

Before importing or adding contacts, set up the properties you want to track — names, plans, signup dates, anything you’ll want to personalize emails by or filter on later. Adding properties first means imports can populate them from day one.
2

Add your contacts

Add contacts manually from the dashboard, import them from a CSV, or create them via the API (with optional double opt-in).
3

Organize them

Group contacts manually using lists, let recipients pick their own preferences using topics, and create segments to target slices of your audience dynamically.
4

Send a campaign

Head to Campaigns and create your first campaign. Pick which lists or segments to target, design your content, and send.

​
What’s Next

Add your first contacts

Learn how contacts work and start adding them

Send your first campaign

Use your audience to send a marketing email