> For the complete documentation index, see [llms.txt](https://docs.hackenproof.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hackenproof.com/welcome/integrations/github-issue.md).

# GitHub Issue

## How the connection HackenProof -> GitHub issue works <a href="#h_ed44c51bfe" id="h_ed44c51bfe"></a>

This guide explains how GitHub connection helps companies when they run a bounty program at HackenProof.

Once you connect your bug bounty program to your GitHub repository (public or private), you can automatically create a GitHub issue:

<mark style="background-color:purple;">remember, you can create a GitHub issue for reports with any STATUS</mark>&#x20;

### How to create a GitHub issue <a href="#h_ed44c51bfe" id="h_ed44c51bfe"></a>

* Open the report you want to create a GitHub issue from
* Navigate to the prerequisites section of the report and find the GitHub issue section

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

* Press the Create GitHub issue button. As a result, the appropriate issue will be created in your GitHub repository
* Also, in the report's GitHub section, you will find the link to the newly created issue:

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

### How to connect the GitHub repository to the HackenProof program <a href="#h_ed44c51bfe" id="h_ed44c51bfe"></a>

* Open your HackenProof program which you want to connect to HackenProof
* Navigate to the Integrations tab and open GitHub app

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

* Connect your HackenProof program to GitHub by specifying Repository URL and your GitHub API token

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

**Repository URL.** <mark style="background-color:purple;">Be sure you use the correct Repository URL.</mark> Here is a correct sample: <https://api.github.com/repos/hackenproof/web3-bug-bounty-platform/issues>, where:

* *<https://api.github.com/repos/>*
* *hackenproof/* - company (owner)
* *web3-bug-bounty-platform/issues* - repo issue

**GitHub API token.** To create your token: GitHub Settings -> Developer settings -> Personal access tokens

<figure><img src="/files/ZhPDEfvK5YESTcvK9lv2" alt=""><figcaption><p>GitHub Settings</p></figcaption></figure>

<figure><img src="/files/wbLVmjSa5kUKhOkbGnpC" alt=""><figcaption><p>Personal settings</p></figcaption></figure>

<figure><img src="/files/axkTAmuU4sYDKD5fSeZ8" alt=""><figcaption><p>Developer settings</p></figcaption></figure>

<figure><img src="/files/fxNppVJh4WMu1RHARRZp" alt=""><figcaption><p>Personal access tokens</p></figcaption></figure>

* Press the Generate personal access token&#x20;

<figure><img src="/files/StnJ8y39SJ2qJTmvdG9m" alt=""><figcaption><p>Generate personal access token</p></figcaption></figure>

* To create a GitHub issue you will need <mark style="background-color:purple;">a token with access to REPO</mark>

<figure><img src="/files/20jX1dHJD8UIfjcW1M48" alt=""><figcaption></figcaption></figure>

<mark style="background-color:purple;">Make sure to copy your personal access token now. You won’t be able to see it again!</mark>

Once you specified Repository URL and your GitHub API token you can connect your bug bounty program with GitHub and start creating GitHub issues