Topic:
Guide to Contact Upload Error Messages in Everbridge Suite.
Description:
There are two types of Contact Upload failures:
- The file fails to upload: (File Status = Failed)
- The file uploads (File Status = Done) but there are records not loaded or partially loaded (loaded with error):
When a CSV file containing Contacts is uploaded to Everbridge, the upload file is listed on the Contacts tab under the Uploads sub-tab in the Everbridge Manager Portal. Choose the icon next to the desired upload file to view the Upload Results page. See the two tables below for explanations of common issues and steps to resolve them.
With the April 2021 release of Everbridge Suite, some of the Contact upload error messages that occur when the file fails to load have been improved. See Knowledge Base Article 000049844 - New Contact Upload Error Messages for a list of the older messages and their new equivalent.
Click on the hyperlinks below for more information on each error.
Error Messages when the Contact Upload File Fails to Load (File Status = Failed)
Error |
Troubleshooting Steps |
---|---|
Error Code: Column Header Misspelled
|
Make sure that the column headings are spelled correctly letter for letter and space for space, and that no new unsupported headers have been added to your contact file. |
Error Code: Encryption is Turned On but file is not encrypted or encrypted incorrectly
|
This can occur if file encryption is enabled for your organization but the contact upload file is not encrypted (or is encrypted with the wrong key).
|
Error Code: Required Column Not Found Error Message:
|
This error can occur because of one of the three root causes below:
|
Error Message: Organization name required for account level upload: Organization Name |
This error means that the Organization Name column header is missing from the contact upload file and the file is being uploaded at the Account level. If you are uploading contacts at the Account level, the file must have an Organization Name column, and and a value in this column for each contact. Acceptable values are the names of the Organizations in your Account. |
(Other) |
If everything in the file appears to be formatted correctly or the contact upload is not listed in the Uploads tab:
|
Error Messages when the Contact Upload File Loads (File Status = Done) but has Records Not Loaded - Critical Error
Error |
Troubleshooting Steps |
---|---|
Error Code: Required Column has NULL value
|
Confirm that the four required columns have a value for each one of your contacts in the file:
NOTE: the "END" header and column data are not always required, but should always be included as a best practice. |
Error Code: Record Type is Not Defined
|
This error should only prevent specific contacts from being uploaded where the "Record Type" field contained a value not configured for your org. Check the Not loaded - critical error tab on the Upload Result page to see the list of contacts that had this issue.
|
Error Message: Contact not found for deletion or is already deleted |
This error occurs when a Delete upload is performed, but the external IDs for the contacts in the CSV do not match the external IDs for the contacts in the organization. When using the Delete upload option, make sure the external IDs in the CSV match those in the organization. NOTE: External IDs are required for an upload using the delete option to be successful. |
Error Message: Organization name is incorrect: Organization Name |
This error means that there are one or more contacts with a blank or unacceptable value in the Organization Name column and the contact upload file is being uploaded at the Account level. Each contact must have acceptable value in the Organization Name column when uploading at the Account level. Acceptable values are the names of the Organizations in your Account and this field is case-sensitive. |
Error Message: Your file either contains line breaks or the number of columns does not match the number of headers |
This error can occur for a few different reasons:
|
Error Message: UPLOADCONTACT_RECORD_TYPE_NULL_ERROR |
This error means that a Record Type was not provided for the contact. Please insure that each contact in your upload file has a value for Record Type. |
Error Messages when the Contact Upload File Loads (File Status = Done) but has Records Loaded With Error
Error Message |
Troubleshooting Steps |
---|---|
This error occurs when a US zip code is missing one or more digits. Often, zip codes that start with 0 will have the leading zero trimmed by Microsoft Excel. |
|
Please ensure that the contact's value for the Country column is in an acceptable format. Values accepted can either be the two character alpha code as defined by ISO 3166 or the full country name as it appears in any Country field of the Everbridge Suite web portal. |
|
Phone number is not formatted correctly for specified country |
This error occurs when a phone number provided in the CSV upload file does not meet country-specific formatting rules. Phone numbers provided in an upload file are validated against formatting and rules specific to the country given for the phone number, and any invalid numbers will cause an error. |
This error displays when a contact record has a value in the Phone Country field but no value is in the corresponding Phone number field. |
|
This error occurs when an address is added to a contact record that already has the maximum amount (5) of addresses allowed. Addresses (or locations) are not overwritten during uploads, and must be removed before any new addresses are added. The following article describes how to remove location information: 000010674 - How to Delete or Replace the Static Location Data for a Contact When Uploading a CSV File to the Everbridge Manager Portal. |
|
This error means that the value given in the CSV upload file for an Additional Information field has not been predefined in the settings. Additional Information fields that have a display format type of 'Single Selection List' or 'Multiple Selection List' require that the values are predefined before they can be used in a CSV upload file. |
|
This error occurs when a contact record in the CSV has a custom value entered incorrectly. |
|
This error means that the Custom Field name in the CSV upload file for an Additional Information field is misspelled or has not been defined in the settings. Additional Information fields must be defined in the settings before they can be used in a CSV upload file. |
|
This error means that the group name provided is invalid. This error can have two different causes:
|
|
UPLOADCONTACT_ADDRESS_LOCATION_ID_NOT_EXISTS |
This error can occur for a couple of different reasons:
|
Article Feedback
While we can’t respond to you directly, we’d love to know how we can improve the article.
Please sign in to leave a comment.