Skip to main content
SmartRecruiters

Bulk User Upload

 

This guide provides an overview how to upload and edit Users in bulk in the SmartRecruiters system. In addition, it contains instructions for how to enable your Users permisison in bulk for SmartRecruiters add-on modules: SmartCRM, SmartPal, SmartAssistant, and SmartMessage. 

 

Requires:
  • SmartRecruit



Introduction
The Bulk User Upload tool empowers large teams to join the SmartRecruiters platform quickly and easily at scale and with access to the products they need. 

What does Bulk User Upload do?
Bulk User Upload allows Admins to…

  • Download a template with required and optional fields for Users

  • Upload a local CSVs containing User data in order to…

    • Add new Users

    • Edit existing Users

    • Activate or Deactivate Users

    • Enable or Disable SR add-on module access (SmartCRM, SmartAssistant, SmartMessage, SmartPal)

  • View the status and details of past Bulk User Uploads

  • View success and error messages for uploaded Users
     

What does it not do?
Bulk User Upload cannot…

  • Retrieve User data from SmartRecruiters.

  • Manage CSV User lists greater than 10MB.

  • Enable company-level access for SmartCRM, SmartAssistant, SmartMessage, SmartPal


For whom?
Bulk User Upload is ideal for Admins at medium to large companies who would like to take a ‘no-code’ approach to adding many Users quickly.

For what part of my hiring journey?
Bulk User Upload can be used any time for changes to Users in SmartRecruiters, but it has the greatest value for recently-joined companies who want to populate their Users from an existing source.

What problem does it solve?
Bulk User Upload provides teams an intuitive way of managing Users at scale. It has many of the same capabilities as the SmartRecruiters API, custom integrations, and access management software, but with greater ease of use.

Customer Readiness
Key Steps: Please contact your CSM to have access to Bulk User Upload enabled in your company’s account. In preparation to use the tool, please view the template & fields below to format your User data

How to Find It?
From your Avatar (top right), go to the Settings / Admin Page
Under Permission Click User Management
 

How to Use It?

  1. From the User Management Page, click Bulk user upload
    1.png

  2. Click DOWNLOAD TEMPLATE to get a CSV with User data headers.
    2.png

  3. Add new or existing User Data to the CSV file, and specify product access. Save and export as CSV.
    3.png

  4. Click UPLOAD CSV and then Choose a file (or drag and drop), and confirm with IMPORT USERS
    4.png

  5. Check that your data columns match the correct User fields and confirm with IMPORT USERS
    5.png

  6. View your Bulk User Upload status, history, and details with the dropdown menu.
    6.png

  7. Click rightmost icon to download CSV results with status and success/error messages for each User.
    7.png

     

Tips & Tricks:
* Please check that you’re in the correct SmartRecruiters environment (Production vs Sandbox)!
* Welcome emails will be sent to users added with Bulk User Upload.
* Test the tool for a small number of users first before adding a larger numbers of users.
* Many file types can be converted to CSV. Check to see if your external User data is convertible to CSV.
* Be sure that you are using commas as delimiters. Sometimes, office tools will change to semicolons.
* Office tool sometimes delete leading 0’s in numbers. Be sure your leading zeroes don’t get dropped!
* Watch out for special text characters, and only use commas as delimiters. This tool uses UTF-8.
* Not sure what SR add-on modules are enabled? Try editing a user manually to view enabled products, or ask your CSM.
* Is your file size larger than 10MB? Try splitting it up!
* You can use email aliases if you choose (name+alias@companyemail.com).
Hiring Team roles cannot be established for Users through this tool. Hiring Teams are set up per job.
 

FAQ
I want to edit Users in bulk. How can I do that with this tool?

You must provide all the required info in your CSV upload (first, last, email, ssoIdentifier*). The tool cannot retrieve User data; you may need to check your HRIS, the API, or your SSO provider for this data. 

Will my created Users receive a welcome email?
If WebSSO is enabled, and if an SSO Identifier was provided, created Users will not recieve a welcome email. If WebSSO is disabled, a welcome email will be sent and Users will be asked to create and login with a password. 

How do I know what values to input into each of the columns?
Acceptable inputs for each column can be found at the end of this Help Center article.

I have an existing sync for my Users in SmartRecruiters. Is this tool right for me?
We recommend against keeping simultaneous integrations for User management. This may lead to interference and Users being overwritten in some cases. Please consult your CSM if you’re unsure about your existing syncs or integrations. 

How many Users can I upload at once?
This tool supports files up to 10MB in size- several thousand users. We recommend splitting up larger files if needed.

I don’t have access to SmartCRM, SmartPal, SmartAssistant, or SmartMessage. What can I do?
While these products may be visible in your CSV template, they might not be enabled for your company. Please contact your CSM to ensure these products are enabled before granting Users access.

What about Users not in an upload list– will they be impacted?
No - Bulk User Upload will only add or edit User profiles if they are included in the CSV upload file.

Why can't I update ExternalData field for my existing Users with Bulk User Upload?
When present, ExternalData field is used as a unique identifier for matching Users. Attempting to edit ExternalData with an upload will result in an error: REJECTED, USER_ALREADY_EXISTS. If ExternalData must be changed or added for existing Users, using the API is the recommended path at this time. 


Additional Resources:

User Management

Add New User to SmartRecruiters

Change a user's name, email, or password


User Template Fields & Required Data
Defaults will be applied to newly added Users. 
Optional fields left blank will be ignored if User exists.

Data Field

Notes

firstname

required
Errors
FIRSTNAME_EMPTY: Add first name
FIRSTNAME_INVALID
FIRSTNAME_TOO_LONG
FIRSTNAME_TOO_SHORT

lastname

required
Errors
LASTNAME_EMPTY: Add last name
LASTNAME_INVALID
LASTNAME_TOO_LONG
LASTNAME_TOO_SHORT

email

required
Must be a valid email address in your company domain
Needs to be unique, globally across SmartRecruiters
Errors
EMAIL_EMPTY: Add email
EMAIL_INVALID
EMAIL_TOO_LONG

externalData

strongly recommended
Required if editing email addresses
Also know as EmployeeID, UniqueID, HrisID, etc.
Distinct from SmartRecruiters User ID
Must be edited using the API
Errors
EXTERNAL_EMPTY: Add relevant external ID
EXTERNAL_INVALID
EXTERNAL_TOO_LONG

ssoIdentifier

required, but only if SSO is enabled
Errors
SSO_DISABLED: Clear SSO ID values from column, or enable SSO
SSO_ENABLED_BUT_IDENTIFIER_IS_NOT_PRESENT: Include it, or disable SSO
SSO_ID_TOO_LONG

activation

optional: defaults to Active
TRUE / FALSE
Active / Inactive
1 / 0
Errors
ACTIVATION_TOO_LONG

systemRole

optional: defaults to Basic / RESTRICTED
Admin / Extended / Standard / Basic / Employee
ADMINISTRATOR / EXTENDED / STANDARD / RESTRICTED / EMPLOYEE
Errors
ROLE_UNKNOWN: Check spelling and match capitalization
ROLE_INVALID
ROLE_TOO_LONG
ROLE_TOO_SHORT

accessGroup

optional: defaults to ‘NA’ / none
Errors
ACCESS_GROUP_UNKNOWN
ACCESS_GROUP_INVALID
ACCESS_GROUP_TOO_LONG

languageCode

optional: defaults to en
List of available languages is maintained here.
Must be expressed in ISO 639-1 format (2 letters), lowercase
Errors
LANGUAGE_CODE_TOO_LONG
LANGUAGE_INVALID_FORMAT
LANGUAGE_CODE_UNKNOWN

countryCode

optional: defaults to ‘NA’ / none
requires city, cannot be used alone
Must be expressed in 2 digit ISO Code format (2 letters), lowercase
Errors
LOCATION_COUNTRY_CODE_UNKNOWN LOCATION_COUNTRY_CODE_INVALID_FORMAT LOCATION_COUNTRY_CODE_TOO_LONG
LOCATION_CITY_AND_COUNTRY_CODE_REQUIRED

city

optional: defaults to ‘NA’ / none
requires countryCode, cannot be used alone
Errors
LOCATION_CITY_INVALID_FORMAT
LOCATION_CITY_TOO_LONG
LOCATION_CITY_AND_COUNTRY_CODE_REQUIRED

SmartCRM

optional: defaults to ‘NA’ / none
requires your company have SmartCRM enabled
TRUE / FALSE
Active / Inactive
1 / 0
Errors
SEAT_SMART_CRM_DEACTIVATED
SEAT_SMART_CRM_INVALID_FORMAT
SEAT_SMART_CRM_TOO_LONG

SmartAssistant

optional: defaults to ‘NA’ / none
requires your company have SmartAssistant enabled
TRUE / FALSE
Active / Inactive
1 / 0
Errors
SEAT_SMART_ASSISTANT_DEACTIVATED
SEAT_SMART_ASSISTANT_INVALID_FORMAT
SEAT_SMART_ASSISTANT_TOO_LONG

SmartMessage

optional: defaults to ‘NA’ / none
requires your company have SmartMessage enabled
TRUE / FALSE
Active / Inactive
1 / 0
Errors
SEAT_SMART_MESSAGE_DEACTIVATED
SEAT_SMART_MESSAGE_INVALID_FORMAT
SEAT_SMART_MESSAGE_TOO_LONG

SmartPal

optional: defaults to ‘NA’ / none
requires your company have SmartPal enabled
TRUE / FALSE
Active / Inactive
1 / 0
Errors
SEAT_SMART_PAL_DEACTIVATED
SEAT_SMART_PAL_INVALID_FORMAT
SEAT_SMART_PAL_TOO_LONG

(Non-Specific Error Cases)

Errors
ERR_COMPANY__NOT_PARSABLE_FILE
ERR_COMPANY__NOT_PARSABLE_FILE_INCORRECT_FILENAME_OR_EXTENSION
ERR_COMPANY__NOT_PARSABLE_FILE_HEADER_TOO_LONG
ERR_COMPANY__NOT_PARSABLE_FILE_HEADER_MISSING_OR_INCORRECT_COLUMN
ERR_COMPANY__NOT_PARSABLE_FILE_HEADER_DUPLICATED_COLUMNS
ERR_COMPANY__NOT_PARSABLE_FILE_HEADER
ERR_COMPANY__NOT_FOUND_DATA_TO_DOWNLOAD
ERR_COMPANY__NOT_FOUND_BULK
ERR_COMPANY__NOT_PARSABLE_FILE_HEADER_MAPPING_DUPLICATED_VALUES
GENERIC_PARSE_ERROR
REJECTED ERROR_INVITATION_EMAIL ERROR_USER_ACTIVATION ERROR_USER_ACCESS_GROUP ERROR_USER_SEATS ERROR_EMPLOYEE_UPDATE ERROR_LOCATION_UPDATE ERROR_SSO_IDENTIFIER_UPDATE ERROR_ACCESS_GROUP_UPDATE USER_ALREADY_EXISTS ACTIVATION_KEY_NOT_AVAILABLE LANGUAGE_DISABLED INVALID_USER_NAME SSO_IDENTIFIER_ALREADY_EXISTS
UNKNOWN_VIOLATION