Note: If you import subscribers that already exist, their subscription settings (the components they're subscribed to) will be overwritten with the most recent settings - we do not "skip" existing subscribers as duplicates.
Log in to your account and select Notifications from the left-hand navigation. In the top right corner of the screen, you'll see a button with a dropdown menu. In the dropdown menu, click on Import Subscribers.
We STRONGLY recommend that you download and use the template CSV. The data in your CSV must be in a specific format and copy/pasting your data into the template will help ensure you don't encounter any errors.
The first column should contain the word "email" so that we know what type of subscriber you are trying to add.
The next column should contain the email address of the person that you want to receive email notifications.
The first column should contain the word "sms" so that we know what type of subscriber you are trying to add.
The next column should contain the phone number of the person you want to receive SMS notifications. This field SHOULD include the zip code but SHOULD NOT include the country code.
Please do not include any spaces or dashes in this field.
The next column should contain the associated two letter country code (e.g. "us" and not "+1") that goes with the phone number.
The first column should contain the word "webhook" so that we know what type of subscriber you are trying to add.
The next column should contain the webhook url that you want the webhook data to be sent to.
The next column should contain an email address that we will send a message to in the event that the webhook starts failing.
If you put any thing other than "no" in this column, the user will a receive a confirmation email about their subscription.
Note: Many SMS subscribers who live in the US cannot opt out of the confirmation. In this case, this option is ignored—users MUST text back to be able to opt in to receiving incident updates.
The component codes column should be a semi-colon separated list of component codes that you want the subscriber to receive notifications for. This column should be ignored unless you have component subscriptions enabled.
To find the specific code for each component, the easiest thing to do is to use the developer tools to inspect the DOM on the Components page. The code will appear in the data-component-code attribute for each component row.
If any subscriber you are trying to upload is missing a required field (see above for which fields are required for each subscriber type), the importer will throw an error.
If the email address validation fails when trying to add an Email or Webhook Subscriber, the importer will throw an error. Make sure email addresses are valid before adding them.
If a phone number or country code validation fails when trying to add an SMS subscriber, the importer will throw an error. Make sure phone numbers and country codes are correct before trying to add them.
The data in the CSV must match that of the downloadable template file.
Many US phone numbers route through the short code STSPG to best guarantee delivery. In this case, users cannot opt out of confirmation, and they MUST text back 'yes' to the opt in to get any incident updates.