Skip to main content
All CollectionsIntegrations
Directory Integrations - CSV Import
Directory Integrations - CSV Import

Synchronize your organizational structure with Insightful through CSV file import

Tamara Filipovic Djordjevic avatar
Written by Tamara Filipovic Djordjevic
Updated over a week ago

The CSV Import feature in Insightful provides a convenient and efficient way to manage your organizational structure and user access. This includes teams, management levels, and role-based access. It provides a simpler way to add, edit and remove employees, managers and admins in bulk.


This option is available to Admins only and the first step is setting up the Directory integration through CSV Import - via Settings → Integrations menu. Once the setup is complete, admins can upload the CSV files and initiate the import.

CSV Files Upload

Upload of CSV files can be done either directly via Insightful Dashboard or via API. The data must be in a specific format. You can use the provided templates for Users and Employees. For the instructions on how to upload the CSV file via API - please refer to the instructions from the dashboard and our API documentation.

👉 Good to know

A file upload and the synchronization can be done no more than once in the 12 hours period and this applies for both manual upload of CSV files and the upload through API.

You can upload files for users and employees separately.

Users dialog is used to manage access to the Dashboard for Admins and Managers and to allocate their scope.

Employees dialog is used to import employees and perform changes such as deactivation, transfer into the right Teams, Team creation if it doesn't exist etc.

Note: Files must be in the right format to be successfully processed; to see the correct format, please click on Download Template above the dialog - there is a Template for Users and a Template for Employees.

Both Users.csv and Employees.csv files should be uploaded at the same time, otherwise the upload cannot be initiated.

Note: When uploading the CSV files, bear in mind that data from CSV files will override current data (environment) on the dashboard.

👉 E.g. if CSV sync is done and active Admin’s email isn’t in the Users.csv file, they will lose their access to the account. Same rule applies to Employees, meaning that employees that are already on the dashboard, but not in the .csv file, will be deactivated after the successful sync.

Synchronization progress and history

After initiating the CSV files upload, you can find the synchronization progress and history on the Settings CSV ImportHistory tab.

If the number of changes is larger than the Approval Threshold set up in the initial configuration, admins must review the requested changes to Approve / Reject them from the same History tab.

There are 5 possible Synchronization statuses such as:

  • File Processing - the files have been uploaded and are being processed by our platform, but the synchronization is not finished yet

  • Waiting for Approval - number of structural changes within the file is larger than the Approval Threshold, so Admin approval is pending to continue the process

  • Approved by *** - the synchronization process has been completed as it was manually approved by the Admin

  • Rejected by *** - the synchronization process hasn’t been completed as it was rejected by the Admin

  • Auto-Approved - the synchronization process has been completed automatically since the number of structural changes within the file was below the Approval Threshold.

  • Error while processing - CSV files are accepted and uploaded, but error has occurred while processing data. Reason the synchronization was not processed is revealed by hovering over a tooltip.

👉 Good to know

  • If synchronization fails due to an error resulting in an Error while processing status, you can immediately start another sync attempt. The 12-hour threshold does not apply in this case. You can also hover over the tooltip to see the reason for the error.

  • Insightful takes data security seriously. All data transferred during CSV import is encrypted and securely stored.

Did this answer your question?