Developer-friendly

TimeHunter API + integrations — REST API, webhooks, payroll export

TimeHunter is not a walled garden. Full REST API, webhooks and ready-made payroll exports for Polish and Czech software. Your ERP and TimeHunter speak as partners.

REST API with keys and rate limits

Every TimeHunter action (creating a session, approving leave, exporting a report) has its REST endpoint. API keys are generated from the admin panel — each with its own scope (read-only / full-access) and rate limit (e.g. 1000 req/hour). Any key can be revoked with one click without affecting others.

API keys with scope

Each key: name, permissions, rate limit, expiry date, audit log.

Per-key rate limiting

Configurable: 100/h to 10000/h. We return X-RateLimit-Remaining headers.

Event webhooks

Employee started a session? Leave approved? We POST to your URL.

OAuth 2.0 + audit

Third-party login via OAuth. Every API call recorded in the audit log with IP.

Payroll export to PL + CZ software

Export hours per employee in a format compatible with the most popular payroll software in Poland and Czechia. No retyping, no conversion, no payroll-error risk.

🇵🇱 Poland: Comarch Optima, Symfonia, enova365, Sage

XLS/CSV format compatible with each program’s importer.

🇨🇿 Czechia: Pohoda, Money S3, Helios, ABRA, FlexiBee

XML/CSV export for each of 5 popular Czech programs.

Webhooks — your system gets a notification in a second

Traditional integrations poll (“check every minute if anything changed”) — wasteful and delayed. TimeHunter sends webhooks: a POST to your URL at the event moment. List: session start, end, leave approved, request rejected, overtime cap exceeded, compliance alert.

15 event types

Session start/stop, leave requested/approved/rejected, overtime warning, compliance violation, employee created.

HMAC SHA-256 signatures

Every webhook has an X-Signature header — verify it came from TimeHunter, not an attacker.

Retry with exponential backoff

Endpoint returned 5xx? We retry 5× (1m, 5m, 25m, 2h, 8h). Dead-letter queue in the panel.

Real integration use cases

Customers wire TimeHunter to many tools — Slack to SAP HR. Common: (1) auto Slack post when someone goes on leave; (2) end-of-month hours push to payroll via API; (3) team schedule sync to Google Calendar; (4) per-project hours export to JIRA / Asana / Trello.

Slack / MS Teams

Webhook → post to #team channel “Anna on vacation June 15-20”.

Google Calendar / Outlook

OAuth integration, schedule and leave sync to the team calendar.

JIRA / Asana / Trello

Pull hours per task — wire into your sprint reports.

SAP HR / Workday

Enterprise integrations via REST API + SFTP. Dedicated account manager.

SDK and sandbox for developers

TimeHunter API ships with full OpenAPI 3.0 docs (Swagger UI), a sandbox with test data, SDKs in PHP/Node/Python and code samples in Go, Rust, Java. Every endpoint has a working curl example. Developers install via npm and have a full client in 5 minutes.

Frequently asked questions

Is the API free on every plan?
API + webhooks are available from the Pro plan. The Start plan includes basic read-only access. Enterprise gets higher limits and a dedicated account manager.
Do you have a PHP/Node.js/Python SDK?
Yes — we publish PHP, Node.js and Python SDKs on GitHub. The API is also fully compatible with any HTTP client (curl, Postman).
Is webhook retry built in?
Yes. If your endpoint returns a 5xx error, we retry 5 times with exponential backoff (1m, 5m, 25m, 2h, 8h). After 5 failed attempts the event goes to a dead-letter queue accessible in the panel.
Can I build a custom export for a niche payroll program?
Yes. The `/api/reports/export?format=csv&columns=…` endpoint lets you choose columns and date format. For truly custom formats, use the hours API → process on your side → import to your ERP.
Do you support OAuth 2.0 / SSO?
OAuth 2.0 for the API (from Pro). SSO login (Google Workspace, Microsoft 365, Okta) in Enterprise. SAML 2.0 on request.
Does the API return data in PLN or CZK?
The API returns amounts in the company’s configured currency (multi-tenant). Each endpoint has a `currency: "PLN"` or `"CZK"` field. Switch the company currency in settings if you change markets.

Try 14 days free

Start a 14-day trial. No card required, full functionality.

Related pages

This website uses cookies

We use cookies to ensure proper functioning of the service, analyze traffic and personalize content. Learn more in our Privacy Policy