Skip to main content
Connect GitHub to Rootly to automate issue tracking, surface commit context during incidents, and capture deployment signals as they happen. This integration allows you to:
  • Create and update GitHub issues from incident workflows
  • Fetch recent commits across repositories during an incident
  • Receive push, pull request, and issue events as Rootly pulses
  • Automatically enrich GitHub PR links shared in Slack with live status updates

​
Before You Begin

You must be an Owner of your GitHub organization and an Admin of your Rootly account to complete this installation.We recommend using a service account so the integration continues to work if a user leaves your organization.
This integration uses a two-step process:
  1. Install the rootlyhq GitHub App from the GitHub Marketplace
  2. Connect GitHub to Rootly via OAuth

​
Permissions

The following GitHub App permissions are required:
PermissionAccess Level
ChecksRead
CodeRead
DeploymentsRead
MetadataRead
Pull RequestsRead
IssuesRead + Write

​
Installation

​
Step 1: Install the GitHub Marketplace App

1

Open your organization's GitHub Apps page

Navigate to the GitHub Apps page for your organization. Replace <your-organization-name> with your organization’s name:
https://github.com/organizations/<your-organization-name>/settings/installations
Document Image
Click GitHub Marketplace.
Document Image
2

Find and add the Rootly app

Search for rootly and click on the Rootly app.
Document Image
Click Add to begin the installation.
Document Image
3

Select the correct organization

If you belong to multiple GitHub organizations, select the correct one and click Install it for free.
Document Image
Confirm the correct organization is selected. Check Allow my billing information to be linked with this organization and click Save.
Document Image
Click Complete order and begin installation.
Document Image
4

Set repository scope and install

Select the desired scope of access (all repositories or specific repositories) and click Install.
Document Image
5

Log out of GitHub

Log out of your GitHub account before proceeding. This is required so Rootly can re-establish the connection under the correct account.
Document Image

​
Step 2: Connect GitHub to Rootly

1

Find GitHub in Rootly Integrations

Navigate to the Integrations page in Rootly and search for github.
Document Image
2

Authorize the connection

You’ll be prompted to sign in to GitHub to authorize the connection to your organization.
Document Image
3

Save the integration

Click Save to complete the setup.
Document Image
GitHub is now connected. You can use the Create Issue, Update Issue, and Get Commits workflow actions, and GitHub events will begin flowing in as pulses.

​
Uninstall

Uninstalling requires two steps — removing the integration from Rootly and uninstalling the GitHub App.
1

Delete from Rootly

Delete the GitHub integration from Rootly via the Integrations page.
Document Image
2

Uninstall from GitHub

Uninstall the rootlyhq app from your organization’s GitHub Apps page.
Document Image