---
title: "Rocket Chat GitHub App Integration"
slug: "github-app"
description: "Integrate GitHub with Rocket Chat. Enable secure collaboration by syncing commits, issues, and pull requests directly into your chat."
status: "update"
updated: 2026-04-09T04:53:04Z
published: 2026-04-09T05:03:03Z
canonical: "docs.rocket.chat/github-app"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub App

The **GitHub** app enhances developer collaboration by seamlessly integrating GitHub and Rocket.Chat. This app enables users to perform various tasks, such as searching and sharing issues and pull requests, subscribing to repository events, creating new issues, reviewing and merging pull requests, and more directly from the Rocket.Chat workspace.

## Install GitHub app

To install the GitHub app in your workspace, follow these steps:

1. Navigate to **Marketplace** ![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot 2025-12-23 130453.png) > **Explore**.
2. Search for the **GitHub** app.
3. Click **Install** and accept the **needed** permissions to install.
4. On the GitHub **App Info** screen, navigate to **Details > API** and note the `GET github-app-callback` URL.

## Create the GitHub OAuth app

GitHub OAuth apps allow your workspace users to easily authenticate their GitHub accounts on the GitHub app. The OAuth app provides access to GitHub data, such as user profiles and repository information, and helps integrate GitHub functionalities. To manage your GitHub PRs, you will need to create an OAuth app and authenticate yourself.

To create a GitHub OAuth app, follow these steps:

1. Log in to your GitHub account.
2. Click your avatar from the menu bar.
3. Select **Settings** and navigate to **Developer settings** > **OAuth Apps**.
4. Click **New OAuth App** to create a new app.
5. Fill in the required information.
  - **Application name**: Set the application name.
  - **Homepage URL**: Fill in the URL of your GitHub application homepage.
  - **Application description**: Add a description of the app.
  - **Authorization callback URL**: Paste the `GET github-app-callback` URL you copied from the **GitHub App**. For example, `https://test-workspace.rocket.chat/api/apps/public/826f0d95-9e25-48a6-a781-a32f147230a5/github-app-callback`
6. Click **Register Application**.
7. After registering the app, click **Generate a new client secret** to create a new client secret for the app.
8. Copy the **Client ID** and the newly created **Client Secret**. You'll need them to configure the Rocket.Chat GitHub app. Copy the **Client Secret** immediately after generating it. GitHub displays it only once. If you lose it, you will need to generate a new one.

## Configure the GitHub app

To configure the GitHub app in your Rocket.Chat workspace, follow these steps:

1. On the **GitHub App Info** screen, go to the **Settings** tab.
2. Paste the **Client ID** and **Client Secret** you copied earlier in `github-app-oauth-client-id` and `github-app-oauth-client-secret` respectively.
3. Click **Save Changes**.

After installing and configuring the app, you can proceed to explore [Using GitHub App](/v1/docs/using-github-app).