Similar to uploading employee information via CSV or API, both of which are manual, you can automatically manage employee data via SFTP using 15Five and your HRIS. SFTP (Secure File Transfer Protocol or SSH File Transfer Protocol) allows you to securely transfer data from one platform (like a HRIS) to another (like 15Five).
SFTP is available for all 15Five customers on all plans.
If your HRIS has a built-in SFTP client, SFTP will allow you to automatically sync your data and ensure that 15Five is always up to date, without requiring manual work on your part. Additionally, you could always try setting up SFTP with a software other than a HRIS or writing your own script from scratch. Since HRIS is the most common use case, we will be focusing on that in this article.
SFTP can be used to manage fields such as reviewer name, email address, and active/inactive status, and more. Think of SFTP as an automated and regularly imported CSV.
Since SFTP is similar to a CSV import, the same column headers are available in SFTP that exist for our Import option. Once a connection is established between 15Five + HRIS/other software, your HRIS will automatically create a CSV using the information you selected and the cadence you selected when setting up the SFTP. That CSV will then be securely sent to 15Five. 15Five will import the data and make all updates. All CSV imports, whether manual or via SFTP, should be UTF-8 encoded.
To import information that is not included in the import column headers list, create a custom attribute and map a field in your HRIS to that custom attribute in 15Five.
What you’ll find in this article:
- How to set up a SFTP connection
- How to disconnect
- Troubleshooting and FAQs
Set up SFTP
Reach out to your HRIS account manager to see if you have the ability to set up SFTP. They may have to enable a setting on the backend. Another option: Your IT or Engineering Team may also be able to write a script that sends automated CSVs to 15Five’s SFTP server.
1. Click on your Settings menu at the top right of your 15Five account and then click 'Features'.
2. Last, click on 'Integrations'.
3. Click Enable to the right of the SFTP option.
4. After acknowledging the pop-up, click Enable SFTP.
5. The 'Setup' tab contains the information you will need in order to set up the SFTP connection on your HRIS side.
If you would like to run a test import, email firstname.lastname@example.org. We can help you run a test import to make sure the information is pulling over properly before you set the imports to be automatically run.
6. Once your files are importing, the 'Import history' tab will show you a list of all past imports. Click into any import to view the details.
7. The 'Settings' tab is where you can choose a Contact person who will receive sync summary and import error emails. The person must be active in 15Five. You can also disable the SFTP connection here.
In order to disconnect SFTP, go to the 'Settings' tab of your SFTP integration page and click Disable under the Disable SFTP section.
Troubleshooting and FAQs
Q: What fields can we maintain via SFTP?
A: SFTP supports the same fields as our bulk import/CSV feature.
Q: Will SFTP overwrite any manual changes that I make in 15Five? For example: My reviewer in 15Five was changed from my manager listed in my HRIS to my team lead. Will it be reverted back to my manager with the next SFTP import?
A: Yes. SFTP imports are the source of truth regarding an individual's data and will overwrite all in-app changes—just like any other provisioning method. Only SCIM has an option to ignore reviewer changes.
Q: How can I sync information from my HRIS to a field that does not exist in 15Five?
A: Add a custom attribute in 15Five and then map the field in your HRIS to the custom attribute field.
Q: Will people be reactivated (or deactivated) in 15Five based on the SFTP syncs?
A: Yes. Just like a CSV import, if the person is noted as active in the file, they will be activated in 15Five. Similarly, if the person is noted as not active in the file, they will be deactivated.
Q: How often do imports happen via SFTP?
A: That depends on the cadence you set up on the HRIS side. The files can be imported as often as you'd like.