Official TypeScript and Python SDKs — plus a skill for AI coding agents

We are happy to announce official client libraries for the Factorial API are now available:

No more hand-rolling HTTP calls, auth headers, or pagination loops. Both SDKs are auto-generated from the same OpenAPI spec that powers this API reference, so they never drift from the API.

What you get

• Typed methods for every endpoint, grouped by domain and mirroring the API hierarchy: client.employees.employees, client.ats.applications, client.timeoff.leaves…
• Authentication handled for you — API key (x-api-key) or OAuth2 bearer token.
• Cursor pagination made simple — list() for a single page, paginate() to stream across pages, all() to collect everything.
• Typed webhook catalog — every event with its payload type, generated from the spec.

Get your first call working in under a minute:

npm install @factorialco/api-client
# or
pip install factorial-api-client

SDK versions follow semver, with the major version tracking the dated API version (e.g. 2.x → 2026-07-01). See the SDKs guide for full details.

Building with an AI coding agent?

We also ship an installable Agent Skill so agents (Claude Code, Codex, Cursor…) know the SDKs cold — the correct SDK method for every endpoint, the webhook catalog, and auth/pagination conventions. No need to copy-paste docs into prompts:

npx skills add factorialco/factorial-api-sdks --skill factorial-api-sdks

It ships separately from the packages and is regenerated on every SDK release. Read more in the AI agents guide.

Source and issues: github.com/factorialco/factorial-api-sdks