GitHub

Receive updates on Issues and PRs in Glue.

Setting up the Github Integration

chevron-rightStep 1: Add the Github app to your workspacehashtag
chevron-rightStep 2: Authorize Githubhashtag

Each user will need to authorize access to their Github account once. You will be prompted to authorize the first time you paste a Github link into a message.

  • Paste a Github link into any message in Glue.

  • A prompt will appear asking you to authorize Glue to access Github. Click Authorize.

Add the app to a Group or Thread

Trigger new threads or messages based on Github activity

chevron-rightAdd the GitHub app to a group* or threadhashtag

The GitHub app can be added to either a group or a thread:

  • Group: When adding the GitHub app to a group, it can be configured to either create new threads or send updates to the Group chat.

  • Thread: The GitHub app will send notifications to the thread.

To add the GitHub app to a group, navigate to the group and then choose Apps from the menu to open the Apps tab of the group settings.

To add the GitHub app to a thread, navigate to the the thread and then choose Thread Settings from the menu. With the settings open, choose the Apps tab.

From the Apps tab of either a group or thread, click to add GitHub.

A modal will appear where you can connect a repository.

chevron-rightConnect a repositoryhashtag

After adding the GitHub app to a group or thread, you will need to choose and configure GitHub repositories that you want to receive updates for.

Start by clicking Connect a Repo

When connecting your first repository, you'll be ask to sign in to GitHub. Click Authorize.

A window will appear where you can log in to GitHub. Click Authorize to let Glue access your account.

After logging in, you'll be asked to install the Glue app for GitHub to you GitHub organization. Click Install.

A window will appear where you can choose a GitHub organization. When choosing repositories, make sure to choose all of the repositories you want to use with Glue, not just the ones you want to use with the selected group or thread. You won't receive updates for any repos until you configure them later in Glue and you can configure different repositories for different groups/threads. When you're done, click Install.

After signing in and installing the app, choose a Repo from the list and then click Add

Choose which events you want to receive messages for and then click Next.

If you're connecting a repo to a group, you'll be asked whether you want to send all updates to the group chat or create threads for each Issue, PR, etc.

The repo you added will now appear in the list of repos connected to the group or thread you selected. From here you can connect another repo to this thread or Remove any previously connected repos.

To manage this list in the future, go back to the Apps section of the group or thread and click the edit button next to GitHub.

chevron-rightChoose which events on Pull Requests or Issues trigger a notification in Gluehashtag

Choose which events you want to receive messages for and then click Next.

If you're connecting a repo to a group, you'll be asked whether you want to send all updates to the group chat or create threads for each Issue, PR, etc.

The repo you added will now appear in the list of repos connected to the group or thread you selected. From here you can connect another repo to this thread or Remove any previously connected repos.

*Note that to add an app to a group, you must be a group admin or workspace admin. Anyone can add an app to a thread.

GitHub link previews in Glue automatically display rich information when you share GitHub links in conversations. These previews show key details about repositories, pull requests, issues, commits, and files without requiring you to leave the conversation. Statuses will update in real time in these previews.

When you paste a GitHub URL into any Glue conversation, the system automatically detects it and generates a rich preview.

Auto-Subscribe to Github Updates

When you share a GitHub issue or pull request link in a thread, Glue automatically subscribes the thread to updates for that issue or PR. Whenever the status changes (e.g., an issue is closed or a PR is merged), a system message is posted to the thread so everyone stays informed.

circle-info

You don't need to add the GitHub app to a thread to auto-subcribe to updates— just share a link with the link preview. If you do not want your thread subscribed to updates, remove the link preview before sending.

Setting requirements

To use Github link previews, your organization needs:

  1. OAuth authentication: Proper permissions to access Github data

  2. Team access: Appropriate permissions to view the linked Github resources

Troubleshooting

chevron-rightI do not want my thread auto subscribed to app updateshashtag
  • Just remove the link preview before sending and your thread will not be subscribed to updates.

chevron-rightHow do I unsubscribe my thread from an app updatehashtag
  • This is coming soon.

Last updated

Was this helpful?