Steps to install GitHub app in your Freshservice account:

  1. Log in to your Freshservice portal and head over to the Admin tab.

  2. Go to Apps and click on Get more Apps to open the Custom App Gallery.

  3. Once you choose GitHub, you will be redirected to the install page of the app.

  4. Login to your GitHub account using Admin Credentials.

  5. Select the Organizations you want to allow Freshservice access to and click on Grant button located next to each organization.

  6. Once access has been granted, click on Authorize Application to link your GitHub account to your service desk.

  7. On GitHub app installation Settings page, enter your Freshservice domain URL and API key and click Authenticate.
  8. Select the possible subset of repositories that you want agents to have access to GitHub issue labels. You can select up to 20 repositories.
  9. If required, select the option that enables automatic mapping of Freshservice incident types to GitHub issue labels.

  10. If required, select the option that allows agents to assign milestones to GitHub issues.
  11. If required, select the status you want to associate with the linked Freshservice incident once a GitHub issue has been closed.
  12. If required, select if you want Freshservice incident responses and comments in GitHub issues to sync with each other.
  13. Click Install.

After installation is complete, if you need to add/delete repositories or change settings follow these steps:

  1. Go to Admin > Apps

  2. Locate GitHub app and click on ‘Key’ icon to Reauthorize the app.
  3. Select new repositories or delete unwanted repositories for the Repositories box and click Update Repositories and click Save.

After installation is complete, if you need to grant access to additional GitHub Organizations follow these steps:

  1. Log in to your GitHub account.

  2. Click on Settings.
  3. Click on Organizations located on the left sidebar.
  4. Select the Organization you want to add.

  5. Click on Third-party access and click on Edit icon next to selected organization.

  6. Click on Grant access. 
  7. The repositories contained in newly added organization will be visible in your Freshservice GitHub app.