# 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="/files/GiZljJedd5WrtmscgxZg" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/CN0v44IO3wm0psv5M1Lr" alt=""><figcaption></figcaption></figure>

* Click **New OAuth App**.

<figure><img src="/files/1jhoaDKpI2r3d3NtTuzp" 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="/files/aMFgR49hb3FCi35YF7Gn" 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="/files/osURYtNXqvkGihaCS4pJ" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/HVaUf6yVCiypoNSvmgfw" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/2ne2nBQSey5HGeQWYa52" 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."

![](/files/5JHL6U2dWFmJ4knZ12ja)

* Click Register application.

<figure><img src="/files/4Npj4OaxCiIfp8YsuSzM" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digit.org/platform/guides/operations-guide/gitops/setting-up-an-oauth-with-github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
