Kua developer documentation

Build with Kua.

Connect your people, payroll and workflows. Start with a Test request, then build the integration your company needs.

Make your first request Explore the API ↗

Company API keys access one company’s data. Call https://api.kuahr.com/v1 with a Test key while building. The Test and Live key guide explains which operations have isolated Test data.

What are you building?

01Prepare people and payrollAdd an employee, prepare a draft and verify the result. Approval and payment stay in the authorised dashboard flow.↗02Keep your systems in syncReceive signed events, handle duplicates and recover a delivery after a receiver failure.↗03Connect workforce workflowsIntegrate leave, salary advances and performance with the right scope and explicit decision boundaries.↗04Understand the Kua–Kola handshakeFollow personal sign-in, company consent, synchronisation and disconnect as separate journeys.↗

Use your preferred language

Node.js and TypeScript

Typed client, request options and webhook verification. Node 18 or later.

Python

Typed models, a context-managed client and webhook verification. Python 3.9 or later.

Install the official @kuahr/node or kuahr SDK at version 0.3.3 from npm or PyPI; follow the installation guides. Source and examples are in Kua’s public SDK repository. Prefer another language? Every company endpoint also accepts plain HTTP.

Know the boundaries

The public API supports employee creation, payroll drafts, workforce resources, events and webhooks. Wallet and payment events are observable; this is not a general wallet-management or payment-execution API. API coverage maps every operation in the public API to its guide.

Webhook history and replay, explicit read scopes and Test isolation are available at api.kuahr.com. Before using live data, complete the go-live checklist. The release notes record the verified releases and remaining journey boundaries.