# GitHub

### Connect GitHub in Violet

1. In [Violet](https://app.violetlabs.com/) (or [VioletGov](https://app.violetgov.com/)), navigate to **Integrations** and click  <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FtlFf29W81Xw97AUJ5zwb%2FScreenshot%202026-02-19%20at%201.13.34%E2%80%AFPM.png?alt=media&#x26;token=c80f613a-d379-4cd4-a5c8-9c04e63e37ea" alt="" data-size="line"> to add a new integration.&#x20;
2. Select <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FfjFf1GMyhnKTpUpQe4MW%2Fgithub.png?alt=media&#x26;token=d5938dda-ee9b-4f3c-aee0-6a3c699fcc34" alt="" data-size="line"> **GitHub**

\[Optional] You can also provide a unique name for the connection based on the credentials you're using, and you can create **restricted permissions** to users or groups:

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FLNq8XfPFudyBudwAhJwe%2Fpermissions.png?alt=media&#x26;token=502752e3-2f38-4c8b-8fa0-2ff8b3a5a19a" alt="" width="375"><figcaption></figcaption></figure>

3. Click **Connect with GitHub** and sign in with your GitHub credentials.
   1. *If you prefer, you can log in using an API Token instead. If so, skip this and head to the* [*next page*](https://docs.violetlabs.com/apps/g/github/optional-connect-with-an-api-token)*.*

![](https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FnfzvYp9KDHYxYvRnuvLw%2FGitHub.png?alt=media\&token=ff7d369a-aa9d-48be-8fa1-708c3fb0785b)

4. Once connected, you can configure which types of data to ingest, how frequently data should be refreshed, etc.&#x20;
5. Last, click **Create** to begin fetching data. You're done!