1
0
mirror of synced 2025-12-22 03:16:52 -05:00
Files
docs/content/github/customizing-your-github-workflow/about-integrations.md
Vanessa Yuen 3df90fc9b8 Hello git history spelunker!
Are you looking for something? Here is all of the GitHub Docs history in one single commit. Enjoy! 🎉
2020-09-27 14:10:11 +02:00

3.8 KiB

title, intro, redirect_from, versions
title intro redirect_from versions
About integrations Integrations are tools and services that connect with {{ site.data.variables.product.product_name }} to complement and extend your workflow.
/articles/about-integrations
free-pro-team
*

You can install integrations in your personal account or organizations you own. You can also install {{ site.data.variables.product.prodname_github_app }}s from a third-party in a specific repository where you have admin permissions or which is owned by your organization.

Differences between {{ site.data.variables.product.prodname_github_app }}s and {{ site.data.variables.product.prodname_oauth_app }}s

Integrations can be {{ site.data.variables.product.prodname_github_app }}s, {{ site.data.variables.product.prodname_oauth_app }}s, or anything that utilizes {{ site.data.variables.product.product_name }} APIs or webhooks.

{{ site.data.variables.product.prodname_github_app }}s offer granular permissions and request access to only what the app needs. {{ site.data.variables.product.prodname_github_app }}s also offer specific user-level permissions that each user must authorize individually when an app is installed or when the integrator changes the permissions requested by the app.

For more information, see:

You can install a preconfigured {{ site.data.variables.product.prodname_github_app }}, if the integrators or app creators have created their app with the {{ site.data.variables.product.prodname_github_app }} manifest flow. For information about how to run your {{ site.data.variables.product.prodname_github_app }} with automated configuration, contact the integrator or app creator.

You can create a {{ site.data.variables.product.prodname_github_app }} with simplified configuration if you build your app with Probot. For more information, see the Probot docs site.

Discovering integrations in {{ site.data.variables.product.prodname_marketplace }}

You can find an integration to install or publish your own integration in {{ site.data.variables.product.prodname_marketplace }}.

{{ site.data.variables.product.prodname_marketplace }} contains {{ site.data.variables.product.prodname_github_app }}s and {{ site.data.variables.product.prodname_oauth_app }}s. For more information on finding an integration or creating your own integration, see "About {{ site.data.variables.product.prodname_marketplace }}."

Integrations purchased directly from integrators

You can also purchase some integrations directly from integrators. As an organization member, if you find a {{ site.data.variables.product.prodname_github_app }} that you'd like to use, you can request that an organization approve and install the app for the organization.

If you have admin permissions for all organization-owned repositories the app is installed on, you can install {{ site.data.variables.product.prodname_github_app }}s with repository-level permissions without having to ask an organization owner to approve the app. When an integrator changes an app's permissions, if the permissions are for a repository only, organization owners and people with admin permissions to a repository with that app installed can review and accept the new permissions.