Factorial

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from FACTORIAL_API_KEY is sent as the x-api-key header.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
FACTORIAL_API_KEYYesFactorial API key, sent without any prefix in the x-api-key header. API keys grant total access and never expire, so store securely. Docs.

Setup

  1. Get a Factorial account with admin access: Sign up at factorialhr.com (a free trial is available) or use an existing company account. Only administrators with full permissions can create and manage API keys.
  2. Create an API key: As an administrator, generate an API key from the Factorial platform user interface (see https://help.factorialhr.com/how-to-create-api-keys-in-factorial). Copy the key value.
  3. Store the key: Set the key as FACTORIAL_API_KEY. It is sent as-is in the x-api-key header, without any prefix.

Provider notes

  • Factorial API keys grant TOTAL access to the account and never expire - rotate them carefully and keep them secret.
  • The API is date-versioned per quarter (this connector uses the 2026-04-01 version); each version is supported for one year after release.
  • Regular (non-admin) users see a restricted version of employee data; admin-generated keys see everything.

Provider API reference.

Tools

ToolAccessDescription
List Employees<br /><code className="reference-identifier">factorial__list_employees</code>ReadList employees
Get Employee<br /><code className="reference-identifier">factorial__get_employee</code>ReadGet employee
List Leaves<br /><code className="reference-identifier">factorial__list_leaves</code>ReadList leaves
Create Leave<br /><code className="reference-identifier">factorial__create_leave</code>WriteCreate leave
List Teams<br /><code className="reference-identifier">factorial__list_teams</code>ReadList teams
List Leave Types<br /><code className="reference-identifier">factorial__list_leave_types</code>ReadList leave types
Delete Leave<br /><code className="reference-identifier">factorial__delete_leave</code>WriteDelete leave

Verify the connection

Call a read tool such as factorial__list_employees with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.