How to add GitHub to Dropbox Dash

You can add your GitHub account to Dropbox Dash so you can access and search your GitHub content directly within Dash. 

This requires OAuth authentication to ensure Dash only retrieves information relevant to your data, giving you full control over what Dash can access. Dash strictly follows the OAuth model, meaning it only accesses the data you specifically permit.

Requirements

To add GitHub to Dash, make sure you meet the following requirements:

• Admin approval: The Dash app must be installed on your GitHub organization(s) and enabled by your admin in Dash.
  •  If GitHub isn’t listed in your Apps or you don’t see results from a specific repository, contact your admin.
• Authorization: You must authorize Dash in GitHub.
• Active account: You need an active account with GitHub.

Integration features

For GitHub, Dash captures the following details: 

• Repositories: Dash gathers information such as the title, content and timestamp, so it can search through these items.
• Labels: Dash gathers the label name to enhance search capabilities.
• Members: Dash gathers the name of the members to enhance search capabilities with people data.
• Pages: Dash gathers the title and content, so it can search through these items and enhance search capabilities.
• Pull Requests: Dash gathers information such as title, content, and timestamp, so it can search through these items.
• Releases: Dash gathers the release name and contents, so it can search through these items.
• Tags: Dash gathers the tag name to enhance search capabilities.

API permissions

When adding GitHub to Dropbox Dash, Dash requests the following authorizations:

•  Verify your GitHub identity: Allows Dash to access your public GitHub profile. This is required by GitHub to be able to integrate with Dash.
• Know which resources you can access: Allows Dash to determine which resources you can access that the app can also access. This allows Dash to make sure you can access the appropriate content on GitHub. This is required by GitHub to be able to integrate with Dash.
• Act on your behalf: Required by GitHub to be able to integrate with Dash.

Learn more about authorizing GitHub apps.

How content syncing works

• Content sync starts right after the connection is made, so you can quickly search for the most relevant data
• Incremental sync occurs every 15 minutes.

How to add your GitHub account to Dropbox Dash

To add GitHub to Dropbox Dash:

1. Log in to dash.ai.
2. Click Apps near the bottom of the left sidebar.
3. Locate GitHub in the apps list.
4. Click ① (add) to the right of GitHub.
5. Enter your login credentials, or select an account to connect to Dash.
6. Review the permissions requested, then click Allow.

How to remove your GitHub account from Dropbox Dash

1. Log in to dash.ai.
2. Click Apps near the bottom of the left sidebar.
3. Locate GitHub in the apps list.
4. Click ① (more options) to the right of GitHub.
5. Click Disconnect.
6. Click Disconnect in the pop-up window. 

• Note: You can reconnect the app anytime.

How to check your added apps

To check what apps you’ve added to Dropbox Dash:

1. Log in to dash.ai.
2. Click Apps near the bottom of the left sidebar.

You’ll see a list of your added apps in the Added section, along with their connection status.

Admins: How to add GitHub for your team

Step 1: Install the Dash app on your desired GitHub organization(s).

Step 2: Enable GitHub in the Dash admin console.
 

Step 1: How to install the Dash app on your GitHub organization(s)

1. Log in to GitHub to install the Dash app on your organization(s).
   • Use this link: Install Dash App.
   • Your username must be your Organization owner role.
2. If you have multiple organizations, select the organization you’d like Dash to access.
   • If you want Dash users to be able to ingest data from repositories in different organizations, you’ll need to install the app in each organization.
   • Ensure you’re logged in with your Organization owner role as you may be asked to sign in again. 
3. Select which repositories Dash can access: All repositories or Only select repositories. If you choose Only select repositories, choose the repositories from the dropdown.

4. Click Install & Authorize to add Dash on your GitHub organization(s).

• Even if you successfully install our GitHub App, GitHub will redirect you to a “Failed to connect” page. This happens because GitHub uses the same redirect URL after installation—even when it succeeds. 
• If you’re an organization owner and just completed the install, you can safely ignore the message.

5. To confirm Dash was successfully installed, go to Third Party Apps, then GitHub Apps. 

Step 2: How to enable GitHub in the Dash admin console

1. Log in to dash.ai using your admin credentials.
2. Click your avatar (profile picture or initials) in the lower left.
3. Select Admin console.
4. Click ①Apps.
5. Click the More apps tab. 
6. Click Add to the right of GitHub.
7. Click Enable GitHub in the pop-up window.

You’ll see a notification that says GitHub was enabled.