Create an OAuth2 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. In Demo, you can create an OAuth 2 application in the demo repository.

However, please fill up the form to get the official OAuth application for production

Firstly, head over to your company repository of OAuth applications (in demo or production)

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 than 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.