PeopleHR connector icon

PeopleHR Connector

Build in-app integrations that sync employee records, absences, holidays, onboarding and salary data between PeopleHR and your product. Use Cyclr’s low-code builder to orchestrate bi-directional syncs, trigger workflows from PeopleHR webhooks and publish integrations in your white-label marketplace.

01

Faster integrations

Ship PeopleHR workflows faster with low-code building blocks.

02

Per-customer credentials

Store and rotate tenant API keys securely for multi-tenant installs.

03

Governed actions

Expose only approved PeopleHR methods as MCP tools.

04

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

What you can integrate with PeopleHR

Integrate employee records, absences, holidays, onboarding, recruitment and salary data between PeopleHR and your application. PeopleHR exposes a JSON REST API for CRUD operations and supports webhooks for starter/leaver, holiday and employee updates. See the PeopleHR API documentation for endpoint lists and developer tools: PeopleHR API documentation. (apidocs.peoplehr.com)

PRODUCT USE CASES

Use cases

Build multi-tenant automations that trigger on PeopleHR events and keep external systems in sync. Common outcomes include provisioning new hires, syncing time-off approvals, exporting payroll-ready salary records and surfacing PeopleHR updates inside your app.

Provision and sync employee records

Create and update PeopleHR Employee records, pull employee lists and sync to your application’s user directory. (help.peopleshr.com)

Sync holiday and absence events

Listen for holiday and absence webhooks, update time-off in your app and trigger approval workflows. (postman.com)

Automate onboarding tasks

Trigger onboarding workflows when PeopleHR sends a New Starter event and create downstream tasks. (postman.com)

ORCHESTRATION

How PeopleHR works with Cyclr

Cyclr sits between your SaaS product and PeopleHR to handle authentication, govern access and orchestrate every API call per customer, at scale.

  1. 1

    Your SaaS product

    Your app requests an action for a specific customer.

  2. 2

    Cyclr orchestration

    Cyclr authenticates, applies policies and routes the request.

  3. 3

    PeopleHR

    PeopleHR processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore PeopleHR methods you can orchestrate through Cyclr.

Holiday Entitlement4

List Holiday Entitlement

Action

Get holiday entitlements.

Update Holiday Entitlement

Action

Update holiday entitlement.

Get Next Holiday Entitlement

Action

Get next holiday entitlement.

Update Next Year Holiday Entitlement

Action

Update next year holiday entitlement.

Employee6

Create Employee

Action

Create an employee.

Update Employee As Leaver

Action

Update an employee as a leaver.

List Employees

Action

List employees.

Get Employee

Action

Get employee.

Update Employee ID

Action

Update an employees ID.

Update Employee

Action

Update employee.

Employee Timesheet4

Create Employee Timesheet

Action

Create an employee timesheet.

Delete Employee Timesheet

Action

Delete an employee timesheet.

List Employee Timesheets

Action

List employee timesheets.

Update Employee Timesheet

Action

Update an employee timesheet.

Vacancy3

List Vacancies

Action

List all vacancies.

Get Vacancy

Action

Get vacancy details.

Create Vacancy

Action

Create a vacancy.

Employee Absence2

Delete Employee Absence

Action

Delete an absence.

List Employees Absences

Action

List absences.

Webhooks14

Sick Absence Deleted

Webhook

Late Absence Created/Updated

Webhook

Sick Absence Created

Webhook

Employee Deleted

Webhook

Maternity/Paternity Absence Updated

Webhook

Holiday Updated

Webhook

Employee Created

Webhook

Holiday Deleted

Webhook

Maternity/Paternity Absence Created

Webhook

Holiday Created

Webhook

Sick Absence Updated

Webhook

Employee Updated

Webhook

Late Absence Deleted

Webhook

Maternity/Paternity Absence Deleted

Webhook

Other Event1

Add Other Event

Action

Employee Holiday1

Get Holiday Details

Action

Return holiday details for the given employee, in the given time frame.

TECHNICAL DETAILS

PeopleHR integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing PeopleHR integrations in Cyclr.

API and authentication

API host
https://api.peoplehr.net
Authentication
API key
Credentials

Provide PeopleHR API key; select scopes and optional IP restrictions when generating the key.

Method categories

Employee; Absence; Holiday; Salary; Onboarding; Recruitment; Queries; Webhooks

View vendor API documentation →

Pagination and rate limits

Pagination

Page-based pagination with meta fields like count, total_count and next_page; follow next_page to retrieve further pages. (help.peopleshr.com)

Rate limits

Default rate limit commonly reported as 30 calls per minute per IP; contact PeopleHR support to request increases. (postman.com)

IMPLEMENTATION

Authentication at a glance

PeopleHR uses API keys created in Settings > API; keys include per-endpoint permissions and optional IP restrictions. Confirm the enabled Cyclr auth option in Console before publishing. (help.peopleshr.com)

Authentication method
API key
Credential required

Provide PeopleHR API key; select scopes and optional IP restrictions when generating the key.

Before you begin:

Enable API license and generate an API key; some endpoints require specific permissions or paid access.

View setup guide

COMMON QUESTIONS

Frequently asked questions

It syncs employee, absence, holiday, onboarding, recruitment and salary data between PeopleHR and your app, and can trigger workflows from PeopleHR webhooks. (help.peopleshr.com)

Use a PeopleHR API key generated in Settings > API; keys include specific endpoint permissions and optional IP restrictions. Cyclr will store the key per tenant during installation. (help.peopleshr.com)

Yes. Provision a PeopleHR API key for each customer (or use the customer’s key), store credentials per tenant in Cyclr, and surface the integration inside your white-label marketplace for each account.

Yes. You can expose selected read/write operations and webhook-driven actions as governed MCP tools in Cyclr, controlling which methods and data each tenant can access.