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.
Connection type: Login credentials (API User)

Prerequisites

You need a paid GreytHR plan (Essential, Growth, or Enterprise) and Admin access on the GreytHR account to create an API User.

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.

Frameworks Supported