Skip to main content

Creating an OAuth App

You can create and register an OAuth App under your personal account or under any organization you have administrative access to. While creating your OAuth app, remember to protect your privacy by only using information you consider public.

  1. In the upper-right corner of any page, click your profile photo, then click Settings.

    Settings icon in the user bar

  2. In the left sidebar, click Developer settings.

  3. In the left sidebar, click OAuth Apps. OAuth Apps section

  4. Click New OAuth App. Button to create a new OAuth app

    Note: If you haven't created an app before, this button will say, Register a new application.

  5. In "Application name", type the name of your app. Field for the name of your app

    Warning: Only use information in your OAuth app that you consider public. Avoid using sensitive data, such as internal URLs, when creating an OAuth App.

  6. In "Homepage URL", type the full URL to your app's website. Field for the homepage URL of your app

  7. Optionally, in "Application description", type a description of your app that users will see. Field for a description of your app

  8. In "Authorization callback URL", type the callback URL of your app. Field for the authorization callback URL of your app

    Note: OAuth Apps cannot have multiple callback URLs, unlike GitHub Apps.

  9. If your OAuth App will use the device flow to identify and authorize users, click Enable Device Flow. For more information about the device flow, see "Authorizing OAuth Apps." Screenshot showing field for enabling device flow

  10. Click Register application. Button to register an application