Docs API Changelog

KaziPeople Developer Platform

Build on KaziPeople

Read HR data from your tenant, react to events with webhooks, and build integrations against a single, audited platform. OAuth 2.0, JSON, cursor pagination — no bespoke plumbing, ever.

Get started Read the docs Request access

Developer access is granted on request — start in a sandbox, then go live.

https://api.kazipeople.com/public/v1

Create an API client, exchange credentials for a token, and make your first request in about five minutes.

Quickstart guide

Employees and Leave endpoints — OAuth 2.0 client credentials, cursor pagination, stable snake_case error codes.

Subscribe to events, verify HMAC-signed deliveries, and build real-time reactions to what happens in KaziPeople.

The integration maturity ladder

Start where you are. Move up when it pays off.

The same platform serves a bank with an API team (L4/L5), an SME emailing spreadsheets (L1/L2), and everything in between — on one audited framework. This documentation covers Levels 4 and 5.

L1Available

Excel / CSV upload

Migration Center: AI field mapping, dry-run, rollback

L2Coming soon

Scheduled file import/export

Saved mappings, on a schedule

L3Coming soon

SFTP drop / pickup

Managed file exchange

L4Available

REST API

Pull/push — this documentation

L5Available

Webhooks

Real-time, event-driven

L6Partial

AI-assisted (Dana)

Field-mapping suggestions today

Integration services & the full ladder

Example use cases

What teams build on KaziPeople

Common integration patterns — read data, react to events, and connect KaziPeople to the systems your organization already runs.

Sync employee records from an ERP or identity provider

Send payroll events to finance and accounting systems

Connect banks or mobile money providers for payments

Trigger onboarding workflows from another system

Push payslip or payment notifications downstream

Connect insurance or pension providers

Build partner apps on top of KaziPeople

All documentation

Getting started

What the KaziPeople API offers and where everything lives.

Getting started

Create a client, get a token, make your first request.

Guides

Client credentials flow, token lifetime, secret rotation.

Pagination, filtering, dates, money, versioning.

Error envelope and stable error-code table.

Cursor walkthrough with a complete loop.

Idempotency-Key semantics for safe retries.

Headers, 429 handling, backoff.

End-to-end recipes in TypeScript and cURL.

API reference

Read-only directory: list and get, filtering and sorting.

Leave requests and balances reference.

Webhooks

Subscriptions, event catalog, retries, delivery logs.

Signature verification

Working HMAC verification code for deliveries.

Platform

Security & compliance

Planes, scopes, PII tiers, audit trail.

Partner onboarding

For banks, pension funds and insurers integrating with KaziPeople.

Integration services

Services catalog and the integration maturity ladder.

Changelog

Version history and deprecation policy.

Build on KaziPeople

Request developer or partner access, start in a sandbox, and connect KaziPeople to your systems.

Request API access Talk to the integration team