GitHub

Receive updates on GitHub Issues and PRs in Glue.

The GitHub integration makes it easy to follow GitHub work without leaving Glue. When you share a GitHub link, Glue shows a rich preview with the latest details and keeps the conversation up to date as issues and pull requests change.

GitHub Link Previews

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.

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.

Trigger new threads or messages based on GitHub activity

Add the app to a Group or Thread

Add the GitHub app to a group* or thread

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.

Connect a repository

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.

Choose which events on Pull Requests or Issues trigger a notification in Glue

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.

Setting up the GitHub Integration

Step 1: Add the GitHub app to your workspace

See instructions for installing an app in your workspace.

Step 2: Authorize GitHub

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.

GitHub 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

Link previews are not appearing

• Verify GitHub app is installed

• Check repository permissions

• Confirm you have access to the repository

I do not want my thread auto subscribed to app updates

• Just remove the link preview before sending and your thread will not be subscribed to updates.

App updates are not sending for a link I sent

• Make sure you include the rich link preview when you send the link to the thread. If you removed the link preview, the thread will not be subscribed.

• App udpates are only supported in threads, not in other chat types.

How do I unsubscribe my thread from an app update

• This is coming soon.