Set up a connection to GitHub

GitHub provides code hosting and version control services that allow developers to build software for open source and private projects in organizations.

GitHub documentation: API guide, Authentication
Additional reference: Supported GitHub APIs

Contents

• A. Set up a GitHub connection
• B. Provide required GitHub application details
• C. Edit advanced GitHub settings
• D. Save and authorize

A. Set up a GitHub connection

Start establishing a connection to GitHub in either of the following ways:

• From the Resources menu, select Connections. Then, click + Create connection at the top right.
      – or –
• While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.

In the resulting Application list, select GitHub.

The Create connection panel opens with required and advanced settings.

B. Provide required GitHub application details

At this point, you’re presented with options for providing GitHub authentication.

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): A reminder of the app you’re editing. 

Configure scopes (required): Scopes are OAuth 2.0 permissions that the GitHub API defines to limit access to your account. To select the scopes for this connection,

1. Click the Configure scopes button.
2. To access all of the scopes in the API, click the » button.
       – or –
   Check the scopes you want to add and click the > button.
3. Click Save to save your scopes and leave the editor.

C. Edit advanced GitHub settings

Before continuing, you have the opportunity to provide additional configuration information, if needed, for the GitHub connection.

D. Save and authorize

To save and authorize the GitHub connection:

1. Click Save & authorize to commit your changes and proceed to log in with GitHub.
2. Enter the email address and password of your registered GitHub account and click Sign in.

The new connection is now successfully added to your account. It will be applied to the current source or destination app, if you created it within a flow. Otherwise, you can proceed to register the connection with an integration.