# GitHub

### **Steps to Create a GitHub Integration** <a href="#steps-to-create-an-github-integration" id="steps-to-create-an-github-integration"></a>

&#x20;

For Personal Access Token permissions and guidelines, follow this link [GitHub | In-Product Guides](https://docs.ozone.one/in-product-guides/github)

**Pre-requisites**

* Username
* personal access token

**Steps:**

1. Enter the details required to link your provider for onboarding the repository and click **Create Integration**.

<figure><img src="/files/UJB46AHv6hZyZVIVeD80" alt=""><figcaption></figcaption></figure>

2. Once the credentials are verified a modal window is shown to choose the organizations you want to integrate into Ozone, here you can click the toggle switch below if you want your personal repositories to be integrated

<figure><img src="/files/DyJylTU7mlkSKHj1iFvR" alt=""><figcaption></figcaption></figure>

3. Once done selecting click on **Submit** below

<figure><img src="/files/bhYrTXGr7einKMWh2KGU" alt=""><figcaption></figcaption></figure>

4. &#x20;Once the integration is created, the resources will be synced, and the status of the resource synced will be shown on the top left of the integration card ( as shown above - *Success)*<br>

   Click the card to get a detailed view of the integration created, user can view the credentials and the resources that are synced, in this case the sync fails the user can click the sync icon on the top right to sync again\
   \
   This integration Syncs the Repositories that you allow from your Github Account

<figure><img src="/files/Dr911KRFSIOS4XnpzKRw" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ozone.one/ozone-end-user-guide/documentation/setup/integrations/managing-source-code-integrations/github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.