You can import your existing subscriptions into OneSignal, or update the data tags associated with a user by using our CSV importer or our REST API. Please see the guides below for more information on how to import your users.

Import Email Address

Upload email subscriptions to OneSignal using a CSV, our API, or manually through the dashboard.

Import Phone Numbers

Upload SMS subscriptions to OneSignal using a CSV, our API, or manually through the dashboard.

Import Data Tags

Use a CSV file to import Data Tags for your users

Importing users

You can import email addresses and phone numbers to create email and SMS Subscriptions using a CSV or API. If you have push tokens, use the Create user or Create subscription (by alias) API.

It is recommended to set the External ID to identify your Users, otherwise they are considered anonymous in OneSignal. If you imported the Subscription data without a known External ID, you can always identify them later by:

1. Calling the SDK login and addSms/addEmail methods in the mobile app or website with the same phone number/email address you imported.
2. Uploading another CSV with the external_id column and email and/or phone_number columns.
3. Use the Update user or Update subscription APIs and set the external_id identity.