Create an OAuth2 application
This page will help you create your first OAuth application
Developer partner or client?
Clients can create their own OAuth application in production. However, if you are a developer partner, or you want your integration to be used by more than one client, you need to get the official OAuth application for production
Create a new application
Administrator permissions required
In order to perform the following steps, you are gonna need to be logged in Factorial with an administrator account. Administrator permissions can be granted to multiple users from the Company Settings section.
If you are a Factorial Partner
Follow these steps in the demo environment to develop and test your integration
However, please fill up the form to get the official OAuth application for production
You will find a more precise guide here
- Firstly, head over to your company repository of OAuth applications:
- Demo link
- Production(clients internal use only)
- Click on
New application
and follow the creation process.
Let's take a closer look at the most important steps in the creation process.
Redirect URI
The redirect URI the user will be redirected once it has granted permissions to your application to use information from Factorial's API.
Note about the Redirect URI
Kindly note that the Redirect URI in the Oauth Application dashboard MUST correspond with the Redirect URI in the body of your request for a new access token
Confidentiality
Indicates whether you can keep the client secret secure and inaccessible to any malicious actor.
Web and mobile applications are not considered secure, as a malicious actor could use debuggers to discover the client secret. Server applications with secure firewalls and protected access are considered secure.
Permissions
The Factorial API enforces the same permissions at the user level as the Factorial web application. This means that Factorial API users will only be able to perform the same actions they are allowed to do in the Factorial platform.
Official OAuth application for production
Developer partners offering their integration to several clients need to request an official OAuth application for production.
Fill up the form to get the official OAuth application (production only)
Updated 3 days ago