Setup and Authorization

FreJun supports the OAuth 2.0 standard for authorizing third-party applications.

To get started:

1. Visit https://product.frejun.com and log in.
2. Navigate to the Settings section.
3. Go to the Developer tab.
4. Click on your existing OAuth app, or select Create App to register a new one.

Once your app is created, you’ll be redirected to a page displaying your Client ID and Client Secret.

Use these credentials to:

• Generate access and refresh tokens for authenticating with FreJun APIs.
• Subscribe to FreJun webhooks.

Requirements

1. An active Frejun account.
2. The following details are required while creating the app.

Parameter	Description
Name	Name of your App
Redirect/Callback URI	Users will be redirected to this URL after granting access to your app

Connecting your application with FreJun

1. Build the Authorization URL with your application's client_id and redirect the user there. It should look like this:
   https://product.frejun.com/oauth/authorize/?client_id=<client_id>
2. Once the user reaches the Authorization page, they will be prompted to log in to FreJun (if not logged in already) and will be redirected to a consent page where they can Accept or Decline.
3. On Accepting, the user will be redirected to the callback URL provided while creating the app with code attached as a query param: <callback_url>?code=<authorization_code>
4. On Declining, the user will be redirected to the callback URL provided while creating the app with code attached as an empty string: <callback_url>?code=
5. The code obtained can be used to create Access & Refresh tokens by invoking the create token endpoint.

info

The authorization code is only valid for 10 minutes.