-
In the upper-right corner of any page, click your profile photo, then click Settings.
-
In the left sidebar, click Developer settings.
-
In the left sidebar, click GitHub Apps.
-
Click New GitHub App.
-
In "GitHub App name", type the name of your app.
Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action.
-
Optionally, in "Description", type a description of your app that users will see.
-
In "Homepage URL", type the full URL to your app's website.
-
In "User authorization callback URL", type the full URL to redirect to after a user authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests.
-
If your app authorizes users using the OAuth flow, you can select Request user authorization (OAuth) during installation to allow people to authorize the app when they install it, saving a step. If you select this option, the "Setup URL" becomes unavailable and users will be redirected to your "User authorization callback URL" after installing the app. See "Authorizing users during installation" for more information.
-
If additional setup is required after installation, add a "Setup URL" to redirect users to after they install your app.
Note: When you select Request user authorization (OAuth) during installation in the previous step, this field becomes unavailable and people will be redirected to the "User authorization callback URL" after installing the app.
-
In "Webhook URL", type the URL that events will POST to. Each app receives its own webhook which will notify you every time the app is installed or modified, as well as any other events the app subscribes to.
-
Optionally, in "Webhook Secret", type an optional secret token used to secure your webhooks.
Note: We highly recommend that you set a secret token. For more information, see "Securing your webhooks."
-
In "Permissions", choose the permissions your app will request. For each type of permission, use the drop-down menu and click Read-only, Read & write, or No access.
-
In "Subscribe to events", choose whether to subscribe your app to Label, Public, Repository, or Watch events.
-
To choose where the app can be installed, select either Only on this account or Any account. For more information on installation options, see "Making a GitHub App public or private."
-
Click Create GitHub App.
