---
title: Integrating with GitHub
slug: integrating-with-github
docTags: 
createdAt: 2020-09-02T04:47:18.000Z
---

Pathfix allows you to easily add end-user OAuth based integration, handling authorization and enable communication between your app and GitHub in just a few minutes.



Before proceeding, you will first need to register your application with GitHub. Please refer the developer documentation provided by GitHub.



## Add your App in GitHub

- Access your GitHub developer settings page
- Select OAuth Apps and locate the app you want to connect with
- If you do not have an app setup, click on `New OAuth App` and setup your new app





![](https://archbee-doc-uploads.s3.amazonaws.com/E6H_--BmYJWG_yGaOUOxt/37gaCalHgBvNOEZ212u6F_image%20%2812%29.png "Image: GitHub OAuth Apps")



- In the `General` tab, you will find your app Client ID and Client Secret
- Copy and save them for use later



![](https://archbee-doc-uploads.s3.amazonaws.com/E6H_--BmYJWG_yGaOUOxt/RM_h2v0aGLrRuqABB3OUK_image%20%2813%29.png "Image: Github Client ID and Client Secret")



- Locate the `Authorization callback URL` and add the Pathfix redirect URL: `https://labs.pathfix.com/integrate/command`
- *Note: The Application name and all other details associated with the App should be your own except for the Redirect URL*





![](https://archbee-doc-uploads.s3.amazonaws.com/E6H_--BmYJWG_yGaOUOxt/fP0xYR7qOO_0j5JeZGpv3_image%20%2814%29.png "Image: GitHub Redirect URL Setup")





## Setup in Pathfix



- Login to your Pathfix account and click on `Add Application`
- Add the name of your SaaS and hit `Save`
- In the `OAuth` tab, select GitHub from the list of providers to integrate with. (Note: You can change the Display `Name` and `Description` in the `General tab`.)
- Enter the `Client ID` and `Client Secret` received from GitHub 
- You can edit the Scopes to add/remove scopes that you want to access
- Hit `Save `





![](https://archbee-doc-uploads.s3.amazonaws.com/E6H_--BmYJWG_yGaOUOxt/MLleoCqmnKDwvwi4e7j4s_image%20%2815%29.png "Image: Setup GitHub Integration in Pathfix")



## Add Integration To Your SaaS



There are 2 steps to adding the integration to your SaaS

1. [End-user authorization](docId\:MsCMNgUGRsGrzSCMLCiXf)
2. [Enable pass-through API](docId\:JiDAxEPNR2Owz8w4_JpBK)