GitHub Setup

Introduction

The Peoplelogic.ai GitHub integration allows you to use your GitHub Personal access token to aggregate events from either github.com or a GitHub Enterprise server.  See What Events Does Peoplelogic.ai Process from GitHub for more information on the events that Peoplelogic.ai aggregates.

Prerequisites

1. You must have admin access to your Peoplelogic.ai account.  If you don't, point your administrator to this page to have them set up the integration.
   
   
2. The GitHub integration requires that you provide a mapping between your employee's GitHub usernames and their Peoplelogic.ai employee account.  See Mapping External Usernames to Employees for more information.  

Configuration

Now, it's time to set up Peoplelogic.ai.  First, click the Add icon near the top right of the Peoplelogic.ai interface and then click Add Integration.

Next, find GitHub and click Connect to GitHub as shown below.

You'll be taken to GitHub where you can authorize the connection between Peoplelogic.ai and GitHub.  It will look something like the following (the names and redirects may be slightly different for you - but look for the logo to match below!).  Be sure to grant access to the organizations you'd like us to aggregate activity for!

Click the green Authorize to complete the process and it should take you back to the screen showing your integration listed among the active integrations.

Testing

Peoplelogic.ai will start to aggregate the events during its next scheduled aggregation run and you should see events showing in the main dashboard timeline.  If you don't see any events and you know there has been activity in your accessible GitHub projects, please contact Peoplelogic.ai Support.