How to Import Mentors

Shelby Marter -

Creating an Mentors file is the fastest way to upload the data of your contacts in your Handshake system. To upload a data file, you have to ensure it is formatted correctly. This article will help you understand what the different fields are that we can upload into Handshake, and how the entries must be formatted. 

Required Fields:

last_name: The mentor's last name.

first_name: The mentor's first name.

email_address: This is the basic identifier for each user in Handshake. It has to be unique for that user, meaning that the same email cannot be tied to two accounts. 

username: This is the identifier that your school uses. This should be 100% unique and unchanging. For some schools, this is the same as email, while other schools it is the card ID or UID.

auth_identifier: This field is whatever students use to sign in to your Single Sign On system. If you aren't using SSO, this should *NOT* be included in your file.

user_type: This field will always be "Mentors" for a mentors file. Please note that it must be capitalized and plural.


mentor_information_attributes:maximum_mentees: Recommended for setting the maximum number of mentees a mentor can have. 


Optional Fields:


mentor_information_attributes:student_contact_preference: Recommended for limiting student contact ways. Must either be "allowed" or "not allowed"

mentor_information_attributes:expertise_names: Recommended for setting mentor's fields of expertise.

mentor_information_attributes:maximum_student_contacts_per_month: Recommended if a maximum number of student contacts exists.

mentor_information_attributes:industry_name: Recommended for setting the industry that the mentor is in.


When your file is ready for import:

  1. Upload directly to the Importer App
  2. Select file type "Mentors"                                            
  3. Once uploaded, review the analyzers for errors and adjust as necessary
  4. Once errors are adjusted, click "Submit and Request Run" 
  5. For information on troubleshooting file issues, please see:


If you do not have access to Handshake's Importer App:

    • Please reach out to your Account Manager for more information. 


Was this article helpful?
0 out of 1 found this helpful
Have more questions? Submit a request