Zoho People Integration

Connect Zoho People with Sprinto to automatically sync employee data, monitor employment status, and streamline people-related compliance checks.

Zoho People is a Human Resource Management System (HRMS) that stores employee records, organisational structure, and employment details.

Integrating Zoho People with Sprinto allows you to automatically sync employee data into the platform. This helps you manage employee lifecycle events, maintain accurate staff records, and automate compliance checks related to people and access.

This integration is primarily used to:

• Sync employee directory data.

• Track employment status changes.

• Support compliance checks such as role assignment and reporting structure.

---

How it Works

Sprinto connects to Zoho People using OAuth 2.0 and retrieves employee data through Zoho’s APIs.

Once connected:

• Sprinto fetches employee records using paginated APIs.

• Employee data is mapped to Sprinto’s People module.

• Compliance checks are evaluated based on synced data.

• Data is refreshed periodically to reflect updates in Zoho People.

Sprinto uses read-only access to ensure no changes are made to your Zoho People account.

Sprinto check for Zoho People

Following are the Sprinto checks available for Zoho People integration:

Sprinto check	Description	Reference procedure
Staff role should be assigned	All in-scope staff members must have an assigned staff role.	How to fix
Reporting manager should be assigned Note: Top management roles like CEO, CTO, etc. are exceptions.	All in-scope staff members should have an assigned reporting manager.	How to fix
Date of joining for new staff should be provided	Define the joining date for all newly onboarded staff members.	How to fix

Prerequisites

Before you begin, ensure the following:

• You have an active Zoho People subscription (paid plan).

• You have Admin or HR Admin access in Zoho People.

• You have access to employee forms and records in Zoho People.

• OAuth access is enabled for your Zoho account.

---

Permissions and Access

Required permissions

The integration requires read-only access to the following:

• Employee records.

• Employee forms.

• Organisation data (company structure).

OAuth scope

• ZOHOPEOPLE.forms.READ – Required to fetch employee-related data.

Access requirements

• You must be a Super Admin or HR Admin in Zoho People to complete the integration.

• The integration uses Bearer token authentication.

---

Features

• Automatic employee directory synchronisation.

• Employment status tracking (active, inactive, terminated, resigned).

• Mapping of employee attributes such as name, email, and role.

• Support for multi-region Zoho People accounts.

• Pagination support for large employee datasets.

• Graceful handling of missing permissions or restricted data.

---

Use Cases

Use case	Description
Employee onboarding tracking	Automatically sync new employees and validate onboarding checks.
Offboarding compliance	Detect terminated or resigned employees and trigger compliance workflows.
Role and reporting validation	Ensure all employees have assigned roles and reporting managers.
Audit readiness	Maintain an up-to-date employee directory for audits.
Centralised people data	Use Zoho People as a single source of truth for staff records.

---

Setup Zoho People Integration

Step 1: Navigate to integrations

1. Log in to the Sprinto dashboard.

2. Go to Settings → Integrations.

3. In the All tab, search for Zoho People.

4. Click Connect next to Zoho People.

---

Step 2: Initiate connection

1. Review the following details in the drawer:

   • Controls and checks automated.

   • Permissions required (read-only).

   • Data accessed by Sprinto.

2. Click Next.

---

Step 3: Review connection details

1. Review:

   • Connection type (OAuth).

   • Prerequisites (Admin access required).

   • Authorisation steps.

2. Click Connect Zoho People.

---

Step 4: Authenticate with Zoho

1. You will be redirected to the Zoho login page.

2. Enter your Zoho People credentials or sign in using SSO.

---

Step 5: Complete connection

• After successful authentication, you will be redirected back to Sprinto.

• The integration will be connected automatically.

---

Post-connection Flow

After successful connection:

• Initial data sync begins automatically.

• Sync may take 15–20 minutes depending on the dataset size.

• Full compliance evaluation may take a few hours.

What happens after sync

• Employees are added to the People module.

• Employment status is mapped and updated.

• Compliance checks are triggered automatically.

Data mapped in Sprinto

• Employee ID.

• Email address.

• First name and last name.

• Reporting manager.

• Date of joining.

• Date of exit.

• Employment status and type.

• Department and location.

Status mapping

Zoho status	Sprinto status
Active	Active
Inactive	Inactive
Terminated	Terminated
Resigned	Resigned

---

Troubleshooting

1. Invalid or expired token (401 error)

• Reconnect the integration.

• Ensure OAuth credentials are valid.

2. Missing permissions or forms (Error code 7024)

• Ensure required forms are accessible in Zoho People.

• Verify ZOHOPEOPLE.forms.READ permission is granted.

• Sprinto will return an empty dataset if access is restricted.

3. Connection validation failure

• Verify Zoho account access and permissions.

• Retry the connection.

• Ensure the correct Zoho region is selected.

4. Timeout issues

• Zoho APIs may take up to 4 minutes to respond.

• Retry the sync if it fails due to timeout.

5. Employees not syncing

• Ensure:

  • Employee records exist in Zoho People.

  • The integrating user has access to those records.

• Note: Zoho may restrict data based on reporting hierarchy.

---

Additional Notes

• Zoho People uses region-specific APIs (US, EU, IN, AU, CA, CN, JP).

• Default region is US if not specified.

• Pagination is supported (200 records per page).

• Date formats vary by region and are normalised by Sprinto.

---

Support

If you need any assistance with the integration, kindly get in touch with Sprinto support.