Skip to main content
Upload a CSV of distinct_ids to a List from the SuprSend dashboard. The list is a snapshot at upload time — re-upload to update it, or switch to database sync if you want it to refresh automatically.
CSV upload only adds users that already exist in SuprSend — it can’t create new user profiles or update user properties and channels. See Creating user profiles to identify users first, or use database sync which can create users during the sync.

​
Setting up the upload

​
1. Create the list

Go to Lists → + New List and fill in: You can edit the name and description later from the List Settings button on the list.
New List modal with list_id, name, and description fields

​
2. Upload the CSV

Select Update Users inside the list details page. Pick how to apply the CSV, upload the file, then click Update Users.
Update Users dialog with Add / Replace options and file picker
CSV format
CSV upload can’t update user properties or channels. If you need to sync additional profile data alongside the list, use database sync instead.

​
Sync logs

Every upload appears on the Sync Logs tab of the list. Each row shows when the file was uploaded, who uploaded it, the outcome, and a summary of how many users were added.
Sync Logs tab showing sync rows with queued-at timestamp, source, updated by, status, and Total and Added counts

​
Total vs. Added

  • Total — rows in the CSV, excluding the header row.
  • Added — users actually added to the list after the upload finished.
Added can be lower than Total for two reasons:
  • The user is already in the list. Duplicate distinct_ids — either within the CSV or from a previous upload — aren’t added again; they count toward Total but not Added.
  • The user doesn’t exist in SuprSend. CSV upload can’t create users, so rows whose distinct_id isn’t already a user in SuprSend are skipped.

​
Troubleshooting

The log shows invalid CSV format - check for the 'distinct_id' column, column names and format of cell values. The header row must contain a column named exactly distinct_id (lowercase, with no leading or trailing spaces). If your source spreadsheet uses a different header — or the header has stray whitespace around it — rename or trim it before exporting.
Either the users are already in the list (safe to ignore) or their distinct_ids don’t exist in SuprSend. CSV upload can’t create users — create them first, or use database sync which can create users on the fly.
Split the CSV into smaller batches and upload them one after another. Each batch appears as its own row in Sync Logs.
Save the CSV as UTF-8. Excel defaults to a locale-specific encoding on export — use Save As → CSV UTF-8, or export from Google Sheets which is UTF-8 by default.

​
Next steps

Send a Broadcast

Use the uploaded list as the audience for a broadcast.

Setup Workflow on List entry/exit

Trigger a workflow when users enter or exit the list.