Overview
The GreytHR integration syncs your employee roster into LowerPlane and automates HR compliance evidence: each employee’s role, reporting manager, and date of joining, plus your organizational structure. LowerPlane uses read-only API User credentials to collect this evidence automatically.LowerPlane collects only the organizational data needed for compliance — names, work email, role, reporting manager, joining date, and employment status. It does not collect payroll, salary, attendance, biometric, or government-ID (PAN/Aadhaar) data.
Prerequisites
How to Create an API User in GreytHR
1
Log in to the GreytHR admin console
Sign in to your GreytHR account at
https://<your-subdomain>.greythr.com using your admin credentials.2
Copy your account subdomain
Copy your GreytHR subdomain from the browser’s address bar — you’ll enter it as your Client Domain in LowerPlane. For example, if the URL is
https://example.greythr.com/, your subdomain is example.greythr.com.3
Open API Users
Go to Settings → My Account → API Users.
4
Create the API User
Click Create API User. Enter
LowerPlane as the username and add a short description (e.g. “LowerPlane compliance evidence”).5
Select the required roles
Under Select Roles, choose the following read-only roles, then click Next:
- Employee API Read Access
- Employee API
- User API
6
Copy the credentials
Copy the generated username and password and save them securely. The password is shown only once — GreytHR will not display it again.
Connecting in LowerPlane
1
Open the integration
Go to Integrations in LowerPlane and find GreytHR.
2
Enter your credentials
Provide the following:
- Client Username — the API User username you created
- Client Password — the API User password
- Client Domain — your GreytHR subdomain (e.g.,
example.greythr.com)
3
Connect
Click Connect. LowerPlane validates the credentials with GreytHR immediately — if the API User is invalid or lacks the required roles, you’ll see the error right away instead of a failed sync later.
What LowerPlane Monitors
Employee Directory
Names, work email, role/designation, and employment status for every active employee.
Reporting Structure
Each employee’s reporting manager, resolved to the manager’s email for segregation-of-duties evidence.
Joining Dates
Date of joining for onboarding, probation, and access-provisioning timelines.
Organizational Structure
Roles and reporting lines that establish authorities and responsibilities.
Automated Checks
Once connected, LowerPlane runs these checks against every employee on each sync:
Employees missing any of these are flagged as failing, and a remediation task is created automatically.