Node.js SDK

npm install @kua/node

import { Kua } from "@kua/node";

const kua = new Kua({ apiKey: process.env.KUA_API_KEY! });

// List payroll runs
const runs = await kua.payrollRuns.list();

// Add an employee (retry-safe with an idempotency key)
const employee = await kua.employees.create(
  {
    firstName: "Jane",
    lastName: "Doe",
    email: "[email protected]",
    employmentTypeId: "3f9a0b1c-…",
    employedAt: "2026-07-01",
  },
  { idempotencyKey: "employee-jane-2026-07" },
);

// Create a draft payroll run
const run = await kua.payrollRuns.create({ year: 2026, month: 7 });

// Poll events incrementally
const events = await kua.events.list({ since: "2026-07-25T10:30:00Z", limit: 100 });

import { KuaError } from "@kua/node";

try {
  await kua.payrollRuns.create({ year: 2026, month: 7 });
} catch (err) {
  if (err instanceof KuaError && err.code === "INSUFFICIENT_SCOPE") {
    // the key is missing the payroll:write scope
  }
}

import express from "express";
import { Kua, verifySignature } from "@kua/node";

const kua = new Kua({ apiKey: process.env.KUA_API_KEY! });
const app = express();

app.post("/kua/webhooks", express.raw({ type: "application/json" }), (req, res) => {
  const ok = verifySignature(req.body, req.header("X-Kua-Signature"), process.env.KUA_WEBHOOK_SECRET!);
  if (!ok) return res.status(400).end();

  const event = JSON.parse(req.body.toString());
  // …handle event (dedupe on event.id)…
  res.status(200).end();
});