Skip to main content

About using Apps

Learn about what a App is and why you would use a App.

About Apps

Apps are tools that extend 's functionality. Apps can do things on like open issues, comment on pull requests, and manage projects. They can also do things outside of based on events that happen on . For example, a App can post on Slack when an issue is opened on .

Finding Apps

You can discover Apps on Marketplace.

You can also build your own App. For more information, see About creating Apps.

Using Apps

In order to use a App, you must install the app on your user or organization account. When you install the app, you grant the app permission to read or modify your repository and organization data. The specific permissions depends on the app, and will tell you what permissions the app requested before you install the app. When you install the app, you will also specify what repositories the app can access. If the app requires any additional configuration, the app will direct you to do so. For more information, see Installing a App from Marketplace for your personal account, Installing a App from Marketplace for your organizations, Installing a App from a third party and Installing your own App.

You may also need to authorize a App to verify your identity, know what resources you can access, or take actions on your behalf. If you need to authorize the app, the app will prompt you to do so. For more information, see Authorizing Apps.

Occasionally, the App will request updated permissions. will notify you when this occurs. In order for the app to continue to function, you will need to review and approve the updated permissions. For more information, see Approving updated permissions for a App.

Before you install or authorize a App, you should make sure that you trust the app developer. If you no longer use the app, you should suspend or uninstall the app and/or revoke your authorization of the app. For more information, see Reviewing and modifying installed Apps and Reviewing and revoking authorization of Apps.

Apps and OAuth apps

also supports OAuth apps. Unlike Apps, you do not install an OAuth app or control what repositories it can access.

Both OAuth apps and Apps use OAuth 2.0.

OAuth apps can only act on behalf of a user, while Apps can either act on behalf of a user or independently of a user.

For more information, see Differences between Apps and OAuth apps and Authorizing OAuth apps.