# ZingHR Integration
ZingHR is a Human Resource Management System (HRMS) and payroll platform used by organisations to manage employee information and HR workflows.
Integrating ZingHR with Sprinto allows organisations to automatically sync employee records and maintain accurate staff data within Sprinto. This reduces manual effort in managing employee lifecycle information and improves the reliability of compliance monitoring.
Once connected, Sprinto retrieves employee data from ZingHR and uses it to support compliance workflows such as staff onboarding validation, reporting structure checks, and employee lifecycle tracking.
***
## How it works
After connecting ZingHR, Sprinto periodically retrieves employee information from your HRMS account. The data is then mapped to staff records within the Sprinto platform.
This integration enables Sprinto to:
* Automatically import employee records
* Track employee onboarding and offboarding
* Validate reporting relationships
* Maintain accurate staff records for compliance checks
If an identity provider is already connected, Sprinto maps employees using their **work email addresses**. This ensures that employee records remain consistent across systems.
If no identity provider is connected, Sprinto uses ZingHR as the primary source of employee information.
***
## Prerequisites
Before connecting ZingHR to Sprinto, ensure that:
* You have **administrator access** to the ZingHR portal.
* You can generate an **API key** from the ZingHR portal.
* Your organisation uses ZingHR to manage employee records.
***
## Data synced from ZingHR
Sprinto retrieves the following employee attributes from ZingHR:
* Employee ID
* Employee name
* Work email address
* Job role
* Reporting manager
* Department
* Joining date
* Employment status (active or inactive)
* Termination or offboarding date
This data enables Sprinto to maintain accurate staff records and evaluate compliance checks related to employee lifecycle events.
***
## Connect ZingHR to Sprinto
1. Log in to the **Sprinto dashboard**.
2. Navigate to **Settings → Integrations**.
3. In the **All** tab, search for **ZingHR** under **HRMS Providers**.
4. Click **Connect** next to **ZingHR**.
Sprinto opens the integration setup drawer.
5. Review the following information:
* Permissions required
* Data accessed by Sprinto
6. Click **Next**.
7. In the **Setup ZingHR Integration** window, enter the following details:
* **Subscription name** – Enter a name to identify the ZingHR integration.
* **API key** – Enter the API key generated from your ZingHR portal.
8. Click **Connect** to complete the integration.
Sprinto will begin synchronising employee data from ZingHR.
***
## Generate the ZingHR API key
To generate an API key in ZingHR:
1. Log in to the **ZingHR portal** as an administrator.
2. Click the **Settings** icon in the top-right corner.
3. Select **Portal**.
4. Click **Token Generator**.
5. Generate a new **API key** and copy it.
Return to the Sprinto integration setup and paste the API key to complete the connection.
***
## Employee mapping behaviour
Sprinto handles employee mapping differently depending on your existing integrations.
### Identity provider already connected
If an identity provider (such as Google Workspace or Okta) is already connected:
* Sprinto matches employees using their **work email addresses**.
* Employees present in ZingHR but not in the identity provider are highlighted.
* Administrators can mark such employees as **in scope** or **out of scope**.
### No identity provider connected
If no identity provider is connected:
* Sprinto imports all employee records from ZingHR.
* ZingHR becomes the primary source of employee data for staff-related compliance checks.
***
## Post-connection behaviour
After the integration is connected:
* Sprinto begins synchronising employee data from ZingHR.
* Staff records are automatically updated based on the data retrieved.
* Compliance checks related to employee lifecycle events are evaluated using the synced data.
Initial data synchronisation may take several minutes to complete.
***
## Troubleshooting
### Integration fails to connect
Ensure that:
* The API key entered is valid.
* The API key was generated by a user with **administrator privileges**.
* The API key has not expired.
***
### Employee data does not appear in Sprinto
If employee records are not visible after connecting the integration:
* Wait for the initial synchronisation to complete.
* Verify that employees exist in the ZingHR portal.
* Ensure the API key is active and has not been revoked.
If the issue persists, disconnect and reconnect the integration.
.png?alt=media&token=a04293da-1c8f-43de-8d9c-9179b6e7d64a)