# 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


---

# 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.hackenproof.com/welcome/integrations/github-issue.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.