# Setting up an OAuth with GitHub

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.

**Note:** A user or organization can own up to 100 OAuth apps.

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

<figure><img src="https://3868804918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegsIWleSdyH9rMLJ8ShI%2Fuploads%2Fgit-blob-e55d6b6bccf253f043fda9ae4686582c3d9c39e4%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* In the left sidebar, click **Developer settings**.
* In the left sidebar, click **OAuth Apps**.

<figure><img src="https://3868804918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegsIWleSdyH9rMLJ8ShI%2Fuploads%2Fgit-blob-dc4c50b14440216d92ffafff3918ea66ab598006%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Click **New OAuth App**.

<figure><img src="https://3868804918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegsIWleSdyH9rMLJ8ShI%2Fuploads%2Fgit-blob-5b3a26473ea2a5c1db2f0699aec9ad53e079ca90%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

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

* In "Application name", type the name of your app.

<figure><img src="https://3868804918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegsIWleSdyH9rMLJ8ShI%2Fuploads%2Fgit-blob-2a4fbf0b4d9dd4aae61bc5473de125f472594abc%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

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

* In "Homepage URL", type the full URL to your app's website.

<figure><img src="https://3868804918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegsIWleSdyH9rMLJ8ShI%2Fuploads%2Fgit-blob-0bbf1e23258e53acef65aa8bf4974ee61d5e5346%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3868804918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegsIWleSdyH9rMLJ8ShI%2Fuploads%2Fgit-blob-898378718a8cbd98696d6637783d36209be5a58f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* In "Authorization callback URL", type the callback URL of your app.

<figure><img src="https://3868804918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegsIWleSdyH9rMLJ8ShI%2Fuploads%2Fgit-blob-9d10ee3b58c1c9c74927f46c11ae6e68373f0a78%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

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

* 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."

![](https://3868804918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegsIWleSdyH9rMLJ8ShI%2Fuploads%2Fgit-blob-39f89b602a86b136a98fa0479295d48fbf97f8bc%2Fimage.png?alt=media)

* Click Register application.

<figure><img src="https://3868804918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegsIWleSdyH9rMLJ8ShI%2Fuploads%2Fgit-blob-199f539b447fa1591a4df03c56a5f4d9729c79f4%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
