Steps to install GitHub app in your Freshdesk account:

  1. Log in to your Freshdesk 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-MintUI Integration, 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 Freshdesk 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 help desk.

  7. On GitHub app installation Settings page, enter your Freshdesk 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 Freshdesk ticket 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 Freshdesk ticket once a GitHub issue has been closed.

  12. If required, select if you want Freshdesk ticket 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. Click on Settings located next to the required Organization.

  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 Freshdesk GitHub app.