Creating an OAuth Application
To enable OAuth 2.0 authentication with StackOne, you need to create an OAuth application in Factorial.
Access the OAuth Applications Page
Navigate to your OAuth applications page based on your environment.
- Production: api.factorialhr.com/oauth/applications
- Sandbox: api.eu2.demo.factorial.dev/oauth/applications
Create a New Application
Click New Application to start the OAuth application creation process.
Configure Application Details
Enter the required application details.
- Name: Enter a descriptive name (e.g.,
StackOne Integration) - Redirect URI: the Callback URL from your Connector Profile
- Confidential: Select based on your security requirements
Configure Scopes
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
Save and Copy Credentials
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
Token Types
Factorial supports two token types for OAuth authentication.
User Token
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 Token
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
Create the StackOne Connector Profile
Create a Connector Profile
Link an Account