{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","partial","img","faq","faq-item"]},"type":"markdown","userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"All subscription plans"},"seo":{"title":"Integrate GitHub with Databox","description":"Connect GitHub to Databox and report on commits, pull requests, issues, and repository activity across personal accounts and organizations.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"],"excludeFiles":[]},{"title":"AI","includeFiles":["docs/ai/*.md"],"excludeFiles":[]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"],"excludeFiles":[]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"],"excludeFiles":[]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"],"excludeFiles":[]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"],"excludeFiles":[]},{"title":"Forecasts","includeFiles":["docs/forecasts/*.md"],"excludeFiles":[]},{"title":"Goals","includeFiles":["docs/goals/*.md"],"excludeFiles":[]},{"title":"Reports","includeFiles":["docs/reports/*.md"],"excludeFiles":[]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"],"excludeFiles":[]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"],"excludeFiles":[]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"],"excludeFiles":[]},{"title":"Support","includeFiles":["docs/support/*.md"],"excludeFiles":[]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"],"excludeFiles":[]}],"hide":false,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrate-github-with-databox","__idx":0},"children":["Integrate GitHub with Databox"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"users","accounts":"all","plans":"all"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["GitHub is a cloud-based platform for version control and software collaboration, used by development teams to host repositories, manage code changes through pull requests, and track work with issues and project boards. Connecting GitHub to Databox brings your repository activity data into dashboards alongside your other business and engineering metrics, so you can monitor development velocity, track open issues and pull request resolution time, and share progress reports with stakeholders in one place."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connection","__idx":1},"children":["Connection"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"before-you-begin","__idx":2},"children":["Before you begin"]},{"$$mdtype":"Tag","name":"IntegrationPermissions","attributes":{"integrationKey":"github"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you've already established a connection, you can ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/add-a-data-source"},"children":["reuse"]}," it to add new repositories, as long as those repositories are accessible with the existing connection's credentials."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-sign-in-with-github","__idx":3},"children":["Step 1: Sign in with GitHub"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To connect GitHub to your Databox account for the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/add-a-connection"},"children":["first time"]}," or with new credentials, log in using your username or email address, Google account, Apple ID, or a passkey."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/integrate-github-with-databox_1.5b9b74eabff429a7aa33e138b5fcb571e978105e7e4aea4c882eb2640df8b306.4783b0ec.png","alt":"github-sign-in-screen","withLightbox":true,"className":"ss-img","style":"margin-top: 10px;"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-select-the-repository","__idx":4},"children":["Step 2: Select the repository"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After authorization, select the GitHub repository you want to report on. Each repository is connected as a separate data source in Databox, so repeat the process to connect additional repositories."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resources","__idx":5},"children":["Resources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"IntegrationResources","attributes":{"integrationKey":"github"},"children":[]}]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Does Databox make any changes to my GitHub repositories or code?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No. Databox requests read-only access to your GitHub repository data. No changes are made to your code, issues, pull requests, or repository settings. You can revoke access at any time from your GitHub account under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Applications > Authorized OAuth Apps"]},"."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"My GitHub account belongs to an organization. Do I need approval to connect?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your organization has OAuth app access restrictions enabled, connecting Databox may require approval from your organization owner. You can request approval from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorized OAuth Apps"]}," tab in your GitHub account settings. Once the organization owner approves the app, the connection will have access to that organization's repositories."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Why does Databox require a GitHub sign-in instead of a personal access token?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The GitHub integration uses OAuth 2.0 for authorization. This means Databox connects through your GitHub account rather than a manually generated token. The OAuth flow grants Databox a scoped, revocable token that limits access to repository data only."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Integrate GitHub with Databox","id":"integrate-github-with-databox","depth":1},{"value":"Connection","id":"connection","depth":2},{"value":"Before you begin","id":"before-you-begin","depth":3},{"value":"Step 1: Sign in with GitHub","id":"step-1-sign-in-with-github","depth":3},{"value":"Step 2: Select the repository","id":"step-2-select-the-repository","depth":3},{"value":"Resources","id":"resources","depth":2}],"frontmatter":{"slug":"integrate-github-with-databox","seo":{"title":"Integrate GitHub with Databox","description":"Connect GitHub to Databox and report on commits, pull requests, issues, and repository activity across personal accounts and organizations."},"keywords":{"includes":["GitHub","GitHub integration","connect GitHub","GitHub data source","GitHub commits","GitHub pull requests","GitHub issues","GitHub repository metrics","GitHub OAuth","GitHub organizations","GitHub branches","development metrics dashboard"]},"metadata":{"userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"All subscription plans"}},"lastModified":"2026-05-29T08:50:36.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/integrate-github-with-databox","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}