For the complete documentation index, see llms.txt. This page is also available as Markdown.

Audiences

Store your mailing and/or suppression lists easily in one place.

The Audiences page provides an easy way to store addresses for mailing and suppression. This is especially helpful if you want to suppress a list for an individual campaign, separate from the global Do Not Mail List. Upload a CSV file comprised of either mailing addresses, or email addresses if you opt to use the address enrichment feature.

Required Fields

Below is an example of the required and optional fields for full address data, and emails for address enrichment. The column headers don't need to match perfectly as you'll be prompted to map the required headers upon upload, and ignore any irrelevant columns that may be present in your file.

Suppressions are matched against either address OR email, so if you are running campaigns using Address Enrichment, a list of emails can be used for suppression.

Mailing Address Data

Custom merge tag columns can be stored for creative, we recommend downloading your creative's CSV Data Guide for a quick, easy and accurate file template.

full_name

required max character count: 40

company

optional

address_1

required

address_2

optional

city

required

state

required

postal_code

required

email

optional

identifier

optional

Emails for Address Enrichment

email

required

full_name

optional

identifier

optional

Merge Tag Columns

When uploading an audience file that contains extra columns with merge tag data, map any and all of those columns as Merge Tag:

In the One Time Send flow during launch, you'll have the option to map these values to their respective merge tags.

Do Not Mail List

Maintain your Do Not Mail list by manually uploading a CSV list or integrating with our Do Not Mail API. Members of this list are automatically suppressed across all campaigns.

Customers (Orders API)

If you're sharing transactional data with Poplar via Shopify or integration with our Orders API, a list of all your customers will automatically populate this audience which can be optionally selected if you'd like to suppress customers who've already purchased.

File Upload

The platform is built to handle file sizes up to 250MB for both Audiences and Transactional uploads. After mapping and submitting your file, depending on the size you could see it queued or processing and upon completion you'll receive a success email. If there are any formatting errors you'll see the option to download an Error Report (also arrives via email):

Error Report

This file will contain the reason the row was rejected with the corresponding line in your file so it is easy to find.

Invalid Addresses

Even if you don't have any formatting errors and you receive an email saying 100% of your records uploaded successfully, your audience could still contain Invalid Addresses flagged by USPS. Invalid Addresses would include invalid city/zip code combination, missing secondary information such as Apartment or Unit number, USPS has marked the address inactive, etc.

Last updated