Create an OAuth 2.0 Client

To make authentication requests to Polar on behalf of your users, you will need an OAuth 2.0 Client. It’s the entity that’ll identify you, as a third-party developer, between Polar and the final user.

1. Go to OAuth Applications in Account Settings

   Go to Account Settings > Developer > OAuth Applications and click the New OAuth App button to start obtaining the OAuth 2.0 client_id and client_secret values.

   
2. Fill the details for your OAuth 2.0 application

   

   Application Name · string · required

   Name of the application that will be shown to the final users.

   Logotype · string

   Upload a logo to be shown on the authorization screen.

   Client Type · string · required

   Confidential Client or Public Client

   Redirect URIs · string · required

   URL(s) where the users will be redirected after granting access to their data.

   When configuring your OAuth client, you must use an https:// URL for security reasons. We block http:// URLs, except when the hostname is localhost. This exception allows you to use http://localhost for convenient testing in development mode.

   

   Scopes · string · required

   The list of scopes your app will be able to ask for.

   Homepage URL · string · required

   URL of your application. It will be shown to the final users on the authorization page.

   Terms of Service · string · required

   URL to your application’s terms of service.

   Privacy Policy · string · required

   URL to your application’s privacy policy.

3. Save the OAuth 2.0 configuration

   Click the Create button to save the OAuth 2.0 configuration

4. Obtain the client_id and client_secret values

   Once the OAuth 2.0 configuration is saved, you will be presented with the Client ID and Client Secret. Store them as client_id and client_secret in your application as environment variables so that they can be securely accessed.