> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Connector

## Intro

GitHub is a web-based version control repository and Internet hosting service. Use Domo's GitHub connector to retrieve data about GitHub followers, repositories, organizations, users, gists, and much, much more. To learn more about the GitHub API, visit their page ([https://developer.github.com/v3/](https://developer.github.com/v3/ "https://developer.github.com/v3/") ).

You connect to your GitHub account in the Data Center. This topic discusses the fields and menus that are specific to the GitHub connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

## Prerequisites

To connect to your GitHub account and create a DataSet, you must have your GitHub credentials (i.e. your username/email address and password).

## Connecting to Your GitHub Account

This section enumerates the options in the **Credentials** and **Details** panes in the GitHub Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

The Domo GitHub connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click **Connect** (or select **Add Account** if you have existing GitHub accounts in Domo) to open the GitHub OAuth screen where you can enter your GitHub credentials. Once you have entered valid third-party tool credentials, you can use the same account any time you go to create a new GitHub DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

<Note>
  **Note:** If you are already logged into GitHub when you connect in Domo, you are authenticated automatically when you click **Add account**. If you want to connect to an account that is different from the one you are logged into, you must first log out of GitHub.
</Note>

### Details P ane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:207;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the GitHub report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p> All Public Events </p></td><td colspan="1" rowspan="1"><p> Returns all public events </p></td></tr><tr><td colspan="1" rowspan="1"><p> All Public Gists </p></td><td colspan="1" rowspan="1"><p> Returns the list of all Public Gists </p></td></tr><tr><td colspan="1" rowspan="1"><p> All Public Repositories </p></td><td colspan="1" rowspan="1"><p> Returns all public repositories </p></td></tr><tr><td colspan="1" rowspan="1"> All Repository Commits </td><td colspan="1" rowspan="1"> Returns all repository commits using a given owner name. </td></tr><tr><td colspan="1" rowspan="1"> All Repository Comments </td><td colspan="1" rowspan="1"> Returns all repository comments using a given owner. </td></tr><tr><td colspan="1" rowspan="1"> All Repository Pulls </td><td colspan="1" rowspan="1"> Returns all repository pulls using a given owner name. </td></tr><tr><td colspan="1" rowspan="1"> All Repository Issues </td><td colspan="1" rowspan="1"> Returns all repository issues using a given owner name. </td></tr><tr><td colspan="1" rowspan="1"><p> All User Issues </p></td><td colspan="1" rowspan="1"><p> Returns all user issues </p></td></tr><tr><td colspan="1" rowspan="1"><p> All Users </p></td><td colspan="1" rowspan="1"><p> Returns the list of all users </p></td></tr><tr><td colspan="1" rowspan="1"><p> Assignees - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns Assignees by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Logged In User Followers </p></td><td colspan="1" rowspan="1"><p> Returns logged in user followers </p></td></tr><tr><td colspan="1" rowspan="1"><p> Logged In User Following </p></td><td colspan="1" rowspan="1"><p> Returns the data of logged in following users </p></td></tr><tr><td colspan="1" rowspan="1"><p> Logged In User Gist </p></td><td colspan="1" rowspan="1"><p> Returns logged in user gist </p></td></tr><tr><td colspan="1" rowspan="1"><p> Logged In User Organizations </p></td><td colspan="1" rowspan="1"><p> Returns logged in user organizations </p></td></tr><tr><td colspan="1" rowspan="1"><p> Logged In User Repositories </p></td><td colspan="1" rowspan="1"><p> Returns logged in user repositories </p></td></tr><tr><td colspan="1" rowspan="1"><p> Logged In User Starred Repositories </p></td><td colspan="1" rowspan="1"><p> Returns logged in user starred repositories </p></td></tr><tr><td colspan="1" rowspan="1"><p> Logged In User Team Members </p></td><td colspan="1" rowspan="1"><p> Returns logged in user team members </p></td></tr><tr><td colspan="1" rowspan="1"><p> Logged In User Team Repositories </p></td><td colspan="1" rowspan="1"><p> Returns logged in user team repositories </p></td></tr><tr><td colspan="1" rowspan="1"><p> Logged In User Watched Repositories </p></td><td colspan="1" rowspan="1"><p> Returns logged in user watched repositories </p></td></tr><tr><td colspan="1" rowspan="1"><p> Organization Issues - Specify Organization name </p></td><td colspan="1" rowspan="1"><p> Returns the data of organization issues by specifying organization name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Organization Members - Specify Organization name </p></td><td colspan="1" rowspan="1"><p> Returns organization members by specifying organization name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Organization Public Events - Specify Organization name </p></td><td colspan="1" rowspan="1"><p> Returns organization public events by specifying organization name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Organization Public Members - Specify Organization name </p></td><td colspan="1" rowspan="1"><p> Returns organization public members by specifying organization name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Organization Repositories - Specify Organization name </p></td><td colspan="1" rowspan="1"><p> Returns organization repositories by specifying organization name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Organization Teams - Specify Organization name </p></td><td colspan="1" rowspan="1"><p> Returns organization teams by specifying organization name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Public Events for a network of Repositories - Specify Username and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns public events for a network of repositories by specifying username and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repositories Issue Events - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns repositories issue events by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Branches - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns repository branches by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Code Frequency - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns repository code frequency by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Collaborators - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository collaborators by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Comments - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns repository comments by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Commit Activity - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the data for repository commit activity by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Commits - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository commits by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Contributor Activity - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns contributor activity by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Contributors - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository contributors by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Deployments - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository deployments by specify the owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Downloads - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository downloads by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Events - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository events by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Forks - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns repository forks by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Hooks - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns repository hooks by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Issues - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository issues by specifying the owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Issues Comments - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository issues comments by specifying the owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Labels - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository labels by specifying the owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Languages - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository languages by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Milestones - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository milestones by specifying the owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Notifications - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository notifications by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Participation - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository participation by specifying the owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Pulls - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository pulls by specifying the owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Readme - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository readme by specifying the owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Releases - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository releases by specifying the owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Subscribers - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository subscribers by specifying owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Tags - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the repository tags by specifying the owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search Code - Specify Search Field, User and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the search code by specifying the search field, user and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search Issues - Specify State of issue and Search Field </p></td><td colspan="1" rowspan="1"><p> Returns the issues by specifying the state of issue and search field </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search Repositories - Specify Search Field </p></td><td colspan="1" rowspan="1"><p> Returns the repositories by search field </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search Users - Specify Search Field </p></td><td colspan="1" rowspan="1"><p> Returns the users by search field </p></td></tr><tr><td colspan="1" rowspan="1"><p> Stargazers - Specify Owner Name and Repository Name </p></td><td colspan="1" rowspan="1"><p> Returns the stargazers by specifying the owner name and repository name </p></td></tr><tr><td colspan="1" rowspan="1"><p> Templates </p></td><td colspan="1" rowspan="1"><p> Returns the templates </p></td></tr><tr><td colspan="1" rowspan="1"><p> User </p></td><td colspan="1" rowspan="1"><p> Returns the user </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Emails </p></td><td colspan="1" rowspan="1"><p> Returns the user emails </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Followers - Specify Username </p></td><td colspan="1" rowspan="1"><p> Returns the user followers </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Following - Specify Username </p></td><td colspan="1" rowspan="1"><p> Returns the user following </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Gist - Specify Username </p></td><td colspan="1" rowspan="1"><p> Returns the user gist </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Gist Comments </p></td><td colspan="1" rowspan="1"><p> Returns the user gist comments </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Issues </p></td><td colspan="1" rowspan="1"><p> Returns the user issues </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Keys - Specify Username </p></td><td colspan="1" rowspan="1"><p> Returns the user keys </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Limit Rate </p></td><td colspan="1" rowspan="1"><p> Returns the user limit rate </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Notifications </p></td><td colspan="1" rowspan="1"><p> Returns the user notifications </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Organization Events - Specify Organization Name </p></td><td colspan="1" rowspan="1"><p> Returns the user organization events </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Organizations - Specify Username </p></td><td colspan="1" rowspan="1"><p> Returns the user organizations </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Performed Events - Specify Username </p></td><td colspan="1" rowspan="1"><p> Returns the user performed events </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Public Repositories - Specify Username </p></td><td colspan="1" rowspan="1"><p> Returns the user public repositories </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Recieved Events - Specify Username </p></td><td colspan="1" rowspan="1"><p> Returns the user received events </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Starred gists </p></td><td colspan="1" rowspan="1"><p> Returns the user starred gists </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Starred Repositories - Specify Username </p></td><td colspan="1" rowspan="1"><p> Returns the user starred repositories </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Teams </p></td><td colspan="1" rowspan="1"><p> Returns the user teams </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Watched Repositories - Specify Username </p></td><td colspan="1" rowspan="1"><p> Returns the user watched repositories </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> User Name/Owner Name (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the user name or owner name you want to pull data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> User Name (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the user name you want to pull data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Owner Name (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the owner name you want to pull data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repository Name (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the name of the repository you want to pull data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Organization Name (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the name of the organization you want to pull data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sort (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter a sort value for your report. This option is available for the below reports: </p><table class="mt-responsive-table"><thead><tr><th colspan="1" rowspan="1"><p> Report Name </p></th><th colspan="1" rowspan="1"><p> Applicable Values </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Search Repositories </p></td><td colspan="1" rowspan="1"><p> stars/forks/updated </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search Code </p></td><td colspan="1" rowspan="1"><p> indexed </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search Issues </p></td><td colspan="1" rowspan="1"><p> comments/created/updated </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search Users </p></td><td colspan="1" rowspan="1"><p> followers/repositories/joined </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Order (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the sort order if you entered a parameter in the <b> Sort </b> field. Use <span class="mt-font-courier-new"> asc </span> for ascending and <span class="mt-font-courier-new"> desc </span> for descending. </p></td></tr><tr><td colspan="1" rowspan="1"><p> State of Issue to be Searched (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter a state to filter by, either <span class="mt-font-courier-new"> open </span>, <span class="mt-font-courier-new"> closed </span>, or <span class="mt-font-courier-new"> all </span> (default is <span class="mt-font-courier-new"> open </span> ). </p></td></tr><tr><td colspan="1" rowspan="1"><p> Past Days (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the number of past days for which you want to retrieve data. The value can be entered as <span class="mt-font-courier-new"> X </span>, <span class="mt-font-courier-new"> XDay </span>, or <span class="mt-font-courier-new"> XDays </span>, where <span class="mt-font-courier-new"> X </span> is a positive integer. For example: <span class="mt-font-courier-new"> 30Days </span>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Issue Filter (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter a value to filter out issues in the authenticated user's context. Possible values are <span class="mt-font-courier-new"> assigned </span>, <span class="mt-font-courier-new"> created </span>, <span class="mt-font-courier-new"> mention </span>, <span class="mt-font-courier-new"> subscribed </span>, and <span class="mt-font-courier-new"> all </span>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Type (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the type of item to search for. This option is available for the below reports: </p><table class="mt-responsive-table"><thead><tr><th colspan="1" rowspan="1"><p> Report Name </p></th><th colspan="1" rowspan="1"><p> Applicable Values </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Search Issues </p></td><td colspan="1" rowspan="1"><p> issue / pr </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search Users </p></td><td colspan="1" rowspan="1"><p> user / org </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Search Field </p></td><td colspan="1" rowspan="1"><p> Enter the keyword to search for. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

## FAQs

<AccordionGroup>
  <Accordion title="How do I know my Github credentials are secure?">
    The login process uses OAuth, so your Github credentials are never seen or stored by Domo. This keeps your login secure. You can revoke Domo's access to your account anytime.
  </Accordion>

  <Accordion title="How often can the data be updated?">
    As often as needed.
  </Accordion>

  <Accordion title="Are there any API limits I should be aware of?">
    You can make up to 5000 requests per hour.
  </Accordion>
</AccordionGroup>
