Import or update users in OneSignal using CSV uploads, REST API, or manual entry. Supports email, SMS, tags, and more for seamless user onboarding or migration.
The page within the Audience section
CSV Import screen
external_id
— Recommended. Identifies Users across all Subscriptions.email
— Required for email subscriptions.phone_number
— Required for SMS subscriptions.subscription_id
— Not recommended. Used for legacy cases or where your backend tracks this unique subscription ID.external_id
.
external_id
helps deduplicate users, supports updates across channels, and enables future imports.external_id
is unique for each user and is the same ID set via the SDK login
method. Otherwise it will reset when the user opens the app.+15555551234
. Creates an SMS subscription.false
removes the email from suppression lists.external_id
, email
, phone_number
, or subscription_id
to identify the user you’re updating.
To add a new email or phone number to an existing user, you must use external_id
. Do not use subscription_id
— it will not link or merge subscriptions.
Shows error message for incorrectly formatted phone numbers
Options to create a segment and delete empty tag values
Import confirmation with status and record counts
contact@onesignal.com
to your email contacts to ensure you receive completion emails. 0
means the list did not contain unique email
and/or phone_number
identifiers to create the subscriptions.200
subscription records modified.email
and/or phone_number
those Subscriptions were likely created.external_id
you set in the CSV does not exist on any subscriptions in the OneSignal appemail
and/or phone_number
subscriptions already exist in the OneSignal app.Example email confirmation.
100
subscriptions were created because the email
and/or phone_number
columns included unique email addresses and/or phone numbers that currently did not exist in the OneSignal app.37814
subscriptions were updated. This is not the count of Users. Remember that users can have multiple Subscriptions.621852
rows of the CSV did not get imported. Either because they did not have External IDs that mapped to users in the OneSignal app, or the emails and/or phone numbers already existed with no unique data to set.support@onesignal.com
and share the CSV file you uploaded along with a screenshot of the confirmation email. We are happy to take a look!The button drop-down menu showing the Manually Add Emails option highlighted