🚧

Feature in Beta

We are still hard at work on this feature and welcome all feedback!

Import User Options

OneSignal provides the following ways to add phone number records into your account:

Import Phone Numbers through Dashboard

Steps:
Audience > All Users > Actions > Import/Update Users

Select Upload CSV next to "Import Phone Numbers"

Import Phone Number csv must ONLY contain the following fields/columns:

• phone_number - must be in the E.164 format
• external_user_id - identifier that can be used to uniquely identify a user

Note: The first row should have the column labels exactly matching the above field names.

You can automatically create a new segment for the imported list. This adds a tag to the newly imported list and auto-creates a segment based on the input value. For example, "SMS_Subscriber_Test_List" in the above image.

Once you Confirm and Import, you will get an email with the results from the CSV Import.

📘

You cannot have multiple phone numbers associated with an external_user_id. If the external_user_id exists, then we will replace the old phone number with the new one.

You cannot have the same phone number associated with multiple external_user_id. Only the last provided external_user_id will be linked with the phone number.

Please reach out to OneSignal support if you prefer to have multiple phone numbers for a given external_user_id.

Update User Records

To add or update custom attributes for the Phone Number records, follow these detailed steps on how to update your subscribers.

Create Segment for SMS Subscribers

If you have already imported phone numbers and added data tags to those numbers then Create a New Segment using SMS subscribers before sending a message. You must

• Add device type filter set to SMS to send to all phone numbers. OR
• Use Data Tags linked specifically to phone number records