Set up Automatic CSV Imports Using an SFTP Server

There are 3 steps to set up an Automatic CSV Import.

Step 1: Connect to your SFTP Server

  1. Hover over the Admin menu and select Sync & Import
  2. Select Automatic CSV Import
  3. Navigate to the Settings tab
  4. Enter your SFTP server’s address in the Server Address field
  5. Enter the Username and Password credentials you use to access your server
  6. Under Path to CSV File, enter the specific path to your file (be sure to include the file’s name and extension)

Make sure the information you entered is correct. Then, select Connect to connect to the server and import data from the CSV file.

Note: If we are unable to connect to your server or follow the file path you entered, you'll see errors below those fields. Correct the errors so that we can connect and find your file, then select Continue to keep moving forward.

Step 2: Map your Data


  1. Choose a unique identifier from the green Match Users By menu. We'll use the data in the column you select to identify existing Profiles in your Pingboard account

    Email - Matches existing profiles by their Email field in Pingboard.
    Name - Matches existing profiles by their First and Last Name in Pingboard. Names in your CSV must match names in Pingboard exactly to be recognized. 
    Pingboard User ID - matches users by their unique Pingboard User ID, downloadable from the Reports page in Pingboard
  2. Column names from your CSV file are represented in the leftmost column; use the drop-down menus on the right to match each CSV column to its target Pingboard Field
  3. Use the middle columns to choose how you want to update each field

    Update if Blank - CSV data is imported only into blank fields in Pingboard, leaving existing data  in Pingboard unchanged.
    Overwrite - Existing data in Pingboard is overwritten by data from your CSV file.
  4. Once you're finished with matching data, select Continue to save your settings for future imports. You can always come back and change these settings later.
Tip: Scroll over the name of any columns on the left side of the page to see data from the first few rows of that column.
Tip: We use the same unique identifiers for identifying existing profiles and to identify and match managers to their employees – the same behaviors and rules for unique ID types above apply to the "Reports To" column in your spreadsheet.
Note: When overwrite is selected, empty cells in a column of your CSV erase existing data from that field in Pingboard. For example, an empty "Location" column in your imported CSV will wipe out existing Location data in Pingboard if overwrite is selected for that field.

Step 3: Preview


  1. On the Preview page, make sure the What's in your CSV summary matches the number of existing and new employees, locations, and groups you're expecting from your import.
  2. If those numbers don't match your expectations, check your CSV for errors, and specifically check to make sure that the unique identifier data in your CSV matches what's in Pingboard. For example, if you're using Email as your unique identifier, check to make sure everyone's Email in your CSV matches their existing Email in Pingboard.
  3. If there are errors, select View Errors to see a summary and info about what happens to that data if you move forward with your import. If you'd like to fix errors before completing your CSV import, select Export to download a CSV file of the errors we found.
  4. Check the Matched Fields section to make sure that your mapping and import settings for each field are correct. Fields with a blue arrow are updated if blank; an orange arrow indicates data in Pingboard will be overwritten with data from your CSV file.
  5. When you're ready, select Run Import.
Note: When you map fields in your CSV to existing fields in Pingboard, those "mappings" will be saved for future imports. We recommend fixing any errors directly in your CSV file before continuing the import so these errors don't recur.


Your import may take a few minutes to complete, so feel free to navigate away from the page while we import your data. We'll send an email as soon as the import is finished.

The Results page provides a summary of how many employee records were updated or created and how many new Groups and Locations were added.

The Results page also shows if any errors occurred during import. Select View Errors to view a summary of the problematic rows. Download the summary to make corrections and re-import that data to Pingboard by selecting Start Export.

Tip: Navigate to the Settings tab of your Automatic CSV Import integration to view results from previous imports.

If you have questions or need help, please contact our Support Team. We're ready to help!

Note: Automatic CSV Imports add and update employees in Pingboard, but do not remove them.

Next Steps: View and Change Automatic CSV Import Settings 

Still need help? Let us know.

Was this article helpful?

0 out of 0 found this helpful