Factorial
With Factorial modules in Make, you can watch, create, update, search, retrieve, and delete:
watch, employee invited and employees, list, retrieve, create, update, terminate, and unterminated employees
list, create, and update leave types
watch, list, create, update and delete leaves
retrieve hiring versions for an employee
search shifts
list locations
list teams
list company holidays
search documents
search folders
To get started with Factorial, create an account at factorialhr.com.
Connect Factorial to Make
To connect Factorial app, you need to obtain the OAuth client credentials.
Log in to your Factorial account.
In your Make account, insert a Factorial module in your scenario and click the Add button next to the Connection field.
In the Connection name field, enter a name for the connection. Click Save.
Optional: Click Show Advanced Settings and enter the client credentials created in your developer account.
Confirm the access by clicking Authorize.
You have successfully connected the Factorial app and can now build scenarios.
Create your own app and client credentials
To create your own app:
Log in to your Factorial developer account.
Click New Application.
Enter a name for the application, add the following redirect URIs, and click Keep.
https://www.integromat.com/oauth/cb/factorialhttps://www.make.com/oauth/cb/factorial
Copy the Application ID and Secret values to a safe place.
You have successfully created the client credentials.
Employees
You can watch employees invited and employees, list, retrieve, create, update, terminate, and unterminated employees using the following modules.
Triggers when an employee has been invited.
Webhook name | Enter a name for the webhook. |
Connection |
Triggers when a new employee has been created.
Connection | |
Limit | Set the maximum number of employees Make will return during one execution cycle. The default value is 10. |
Retrieves a list of employees. Only admins can see all the employees' information, regular users will get a restricted version of the payload as a response.
Connection | |
Limit | Set the maximum number of employees Make will return during one execution cycle. The default value is 10. |
Retrieves an employee.
Connection | |
Employee ID | Select or map the Employee ID whose details you want to retrieve. |
Creates an employee.
For field descriptions, see the Factorial API reference.
Updates an employee
Connection | |
Employee ID | Select or map the Employee ID whose details you want to update. |
For field descriptions, see the Factorial API reference.
Terminates an employee.
Connection | |
Employee ID | Select or map the Employee ID you want to terminate. |
Terminated on | Enter the date when the employee was terminated. See the list of supported date and time formats. |
Unterminates an employee.
Connection | |
Employee ID | Select or map the Employee ID you want to unterminate. |
Leave Types
You can list, create, and update leave types using the following modules.
Retrieves a list of leave types.
Connection | |
Limit | Set the maximum number of leave types Make will return during one execution cycle. The default value is 10. |
Creates a leave type.
For field descriptions, see the Factorial API reference.
Updates a leave type.
Connection | |
Leave Type ID | Select or map the Leave Type ID whose details you want to update. |
For field descriptions, see the Factorial API reference.
Leaves
You can watch, list, create, update and delete leaves using the following modules.
Triggers when a new leave has been created.
Connection | |
Limit | Set the maximum number of leaves Make will return during one execution cycle. The default value is 10. |
Retrieves a list of leaves.
Connection | |
Limit | Set the maximum number of leaves Make will return during one execution cycle. The default value is 10. |
Creates a leave.
For field descriptions, see the Factorial API reference.
Updates a leave.
Connection | |
Leave ID | Select or map the Leave ID whose details you want to update. |
For field descriptions, see the Factorial API reference.
Deletes a leave.
Connection | |
Leave ID | Select or map the Leave ID you want to delete. |
Hiring Versions
You can retrieve hiring versions for an employee using the following modules.
Retrieves hiring versions for an employee.
Connection | |
Employee ID | Select or map the Employee ID whose details you want to retrieve. |
Limit | Set the maximum number of versions Make will return during one execution cycle. The default value is 10. |
Shifts
You can search shifts using the following modules.
Searches for shifts.
Connection | |
Month | Enter a valid month in the calendar ranging from 01 to 12 in the format MM. For example, |
Year | Enter a valid year in the YYYY format. For example, |
Limit | Set the maximum number of shifts Make will return during one execution cycle. The default value is 10. |
Locations
You can list locations using the following modules.
Retrieves a list of locations.
Connection | |
Limit | Set the maximum number of locations Make will return during one execution cycle. The default value is 10. |
Teams
You can list teams using the following modules.
Retrieves a list of teams.
Connection | |
Limit | Set the maximum number of teams Make will return during one execution cycle. The default value is 10. |
Company Holidays
You can list company holidays using the following modules.
Retrieves a list of company holidays.
Connection | |
Limit | Set the maximum number of company holidays Make will return during one execution cycle. The default value is 10. |
Documents
You can search documents using the following modules.
Searches for documents.
Connection | |
Employee ID | Select or map the Employee ID whose documents you want to search. |
Folder ID | Select or map the Folder ID to search the documents. |
Limit | Set the maximum number of documents Make will return during one execution cycle. The default value is 10. |
Folders
You can search folders using the following modules.
Searches for folders.
Connection | |
Name | Enter a name to retrieve the list of folders by name. |
Active | Select whether to retrieve the list of active employees. |
Limit | Set the maximum number of folders Make will return during one execution cycle. The default value is 10. |
Other
You can call APIs using the following module.
Note
For the list of available endpoints, refer to the Factorial API documentation.
Performs an arbitrary authorized API call.
Connection | |
URL | Enter a path relative to |
Method | GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry. |
Headers | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
Query String | Enter the request query string. |
Body | Enter the body content for your API call. |
Example of use - Search Tasks
The following API call returns all tasks from your account.
URL: /v1/employees
Method: GET
Matches of the search can be found in the module's Output under Bundle > Body.
In our example 6 employees were returned:
