In Factorial, we have developed our integrations framework, allowing Factorial to sync data (employee compensation, expenses…) into external systems (payroll software, ERPs).

This functionality is exposed through our public API, so that external partners and clients can integrate external software more easily and consistently.

Why an integrations framework?

Factorial is the hub of the employees system of record. All the information related to employees, contracts, time, talent... is managed and stored in Factorial.

Around this ecosystem, we have other tools we need to integrate with: Payroll Software, ERPs, Time tracking..

Our integrations framework allows Factorial to integrate with all these softwares in a coherent way, keeping the same UX experience across Factorial's products, despite of the external software or the domain.

How does it work?

📝 Integration Registration

Partners must register their integration to work with the integrations framework

🔧 Setup integration for the first time

To get started, the partner must to specify 2 things to Factorial team:

Webhook URL

• URLs where Factorial will send the webhook must be provided. One for production and another for the test environment
• This URL will be used for all companies using the integration.

Integration UUID

• Factorial will provide the Partner with an integration_uuid That represents your integration across Factorial environments and is the shared integration identifier between both systems. You will need it in the following steps.

🔧 Setup integration for a new client

When a new client starts using the integration for the first time, some configuration may be required on the partner's side.

Once the setup is finished on the partner's side and the integration is ready to be used, it must be enabled in Factorial for that specific client (company) by calling the following endpoint:

Create an Installation Factorial Creates an Installation​

 POST {baseUrl}/api/{version}/resources/marketplace/installations 
 
{
  "integration_uuid": string,  // your integration identifier
  "company_id": integer
}

Direction

The integrations framework supports 2 directions on how the data is transferred between Factorial and the external software

Inbound: External Software → Factorial

Outbound: Factorial → External Software

What domains are supported?

Please refer to each domain page for details on each Factorial product

Payroll integrations

Finance integrations