Factorial OAuth 2.0 connector profile – StackOne setup guide

Navigate to your OAuth applications page based on your environment.

• Production: api.factorialhr.com/oauth/applications
• Sandbox: api.eu2.demo.factorial.dev/oauth/applications

Click New Application to start the OAuth application creation process.

Enter the required application details.

• Name: Enter a descriptive name (e.g., StackOne Integration)
• Redirect URI: https://api.stackone.com/connect/oauth2/factorialhr/callback
• Confidential: Select based on your security requirements

Select the OAuth scopes your application needs access to. Available scopes include employees, contracts, time_off, recruitment, and more.

• Select only the scopes required for your integration
• See OAuth Scopes documentation for full details

Click Submit to save the application. Your credentials will be displayed.

• Copy the Client ID and Client Secret and store them securely
• The Client Secret is only shown once at creation and cannot be retrieved later
• The Client ID can be found on the application details page anytime

User tokens make requests on behalf of a specific user. The user must be an employee in Factorial with appropriate permissions.

• Expires in 1 hour
• Requires token refresh
• Actions are scoped to the user’s permissions

Company tokens make requests on behalf of the company. Recommended for integrations that need company-wide access.

• Never expires (but can be revoked)
• No refresh needed
• Full company-level access