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 app must be enabled by your Dash admin. If GitHub isn’t listed in your Apps, 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.
• Issues: Dash gathers information such as issue title, state, 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

Before your team members can add their GitHub accounts to Dropbox Dash, you’ll need to enable it in the admin console. To do this:

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.