Skip to main content

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.
ParameterDescription
NameName of your App
Redirect/Callback URIUsers 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 and email of the user attached as a query param: <callback_url>?code=<authorization_code>&email=<user_email>
  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.