Troubleshooting


If you are trying to get started with Zenhub, or looking to use Zenhub with a new organization but are seeing an error on the extension that you don't have permissions, or are seeing your organization not appear in the web app this is most likely because your GitHub organization hasn't yet granted Zenhub permissions.  If you have multiple organizations, you will need to grant Zenhub access to each one you wish to use it on. 


Checking access permissions

To confirm that your access is being blocked due to access restrictions, go to your GitHub profile settings. Once in Settings, head to Applications > Authorized OAuth apps



Click on Zenhub under the list of applications that appear. All authorized organizations connected to Zenhub will be listed.


Checking authorized oAuth apps in GitHub


If you see a red X next to the organization where you are having issues loading your Board or seeing it appear in the web app, this indicates third party restrictions are enabled. This prevents Zenhub from loading.


If you see a green next to your organization and are still experiencing an issue accessing Zenhub, there might be a permission caching error. If Zenhub was granted permissions within the last 3 hours, you can force Zenhub to re-check for your new permissions by revoking your token under the authorized oAuth apps section, and re-authenticating by clicking Sign in on the bottom right of any page in the extension, or refreshing the web app. 


Checking authorized oAuth apps in GitHub


Only admins of your GitHub organization can grant access to oAuth apps.


Granting third-party permissions

If you're an admin of the organization, you can grant access by heading to your GitHub profile settings > Applications > Authorized oAuth Apps. Select Zenhub under the list of applications. Next to the organization you want to grant Zenhub permissions for, select Grant


Alternatively, an administrator of the organization can grant access by navigating to the settings page for the organizaton in GitHub > third party access > grant access:


Need help getting started?

You can learn more in GitHub's third-party restrictions support documentation. Or, get in touch at any time if you're still experiencing issues getting Zenhub setup.