Skip to main content

​
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.

​
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

​
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.