Import

Use our CSV uploader, API endpoints, or the OneSignal dashboard to add and update users.

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.

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 Create user or Create alias APIs.