Python SDK

pip install kua

import os
from kua import Kua

kua = Kua(api_key=os.environ["KUA_API_KEY"])

# List payroll runs
runs = kua.payroll_runs.list()

# Add an employee (retry-safe with an idempotency key)
employee = kua.employees.create(
    first_name="Jane",
    last_name="Doe",
    email="[email protected]",
    employment_type_id="3f9a0b1c-…",
    employed_at="2026-07-01",
    idempotency_key="employee-jane-2026-07",
)

# Create a draft payroll run
run = kua.payroll_runs.create(year=2026, month=7)

# Poll events incrementally
events = kua.events.list(since="2026-07-25T10:30:00Z", limit=100)

from kua import KuaError

try:
    kua.payroll_runs.create(year=2026, month=7)
except KuaError as err:
    if err.code == "INSUFFICIENT_SCOPE":
        ...  # the key is missing the payroll:write scope

import os
from flask import Flask, request, abort
from kua import verify_signature

app = Flask(__name__)

@app.post("/kua/webhooks")
def receive():
    if not verify_signature(
        request.get_data(),  # raw bytes, NOT request.json
        request.headers.get("X-Kua-Signature"),
        os.environ["KUA_WEBHOOK_SECRET"],
    ):
        abort(400)
    event = request.get_json()
    # …handle event (dedupe on event["id"])…
    return "", 200