GitHub Integration

HighFly integrates with GitHub to connect your code and project management workflows.

GitHub App for Organizations

The GitHub App provides organization-level integration with your GitHub repositories.

Installing the GitHub App

1. Navigate to your organization's Integration settings
2. Go to the "GitHub" section
3. Click "Open"
4. You'll be redirected to GitHub
5. Select the GitHub organization you want to connect
6. Review and approve the required permissions
7. The app will be installed and linked to your HighFly organization

Webhooks are automatically configured when you install the GitHub App. No manual setup is required.

Personal GitHub Account Linking

Individual users can link their personal GitHub accounts to enable PR linking from GitHub.

Linking Your Account

1. Go to your Connected Accounts settings
2. Navigate to the "GitHub" section
3. Click "Connect"
4. Authorize HighFly to access your GitHub account

You can unlink your account at any time from the same settings page.

Pull Request Integration

Automatic Issue Linking

Pull requests are automatically linked to HighFly issues when:

• A PR is opened with an issue identifier in the branch name (e.g., ENG-123-feature-branch links to issue ENG-123)
• An issue identifier is mentioned in a PR comment
• A PR URL is pasted into a HighFly issue

Note: PR linking can only be done by users who have linked their personal GitHub account.

PR Updates

When a linked pull request's status changes, HighFly tracks the PR status, review status, and merge status. Comments on linked PRs can be synced to HighFly issue comments.

Best Practices

Use consistent branch naming with issue identifiers (e.g., user1/ENG-123-feature-name) to enable automatic linking. Include the full issue identifier format: {TEAM-PREFIX}-{NUMBER}.

Troubleshooting

PR not linking: Ensure the branch name contains the issue identifier (e.g., ENG-123), that you've linked your personal GitHub account, and that the GitHub App is installed in your Github organization.

Missing updates: Refresh the page or verify the GitHub App is installed and has the necessary permissions.

For additional help, check the Support & Resources page.