Skip to content
Convor
Convor Docs
Integrations

GitHub Integration

Install the Convor GitHub App, select a repository, and create issues from support conversations.

Connect GitHub to create repository issues from support conversations. Settings apply to the selected Convor site.

No personal access token required

Convor uses a GitHub App installation. Choose the account and repositories it may access, without generating or pasting a PAT.

Prerequisites

  • Permission to install GitHub Apps on the target user account or organization
  • Access to the target repository
  • Permission to create issues
  • Administrator access to Convor
  • The Workflows & Collaboration integration module

Connect GitHub

  1. Open Integrations → GitHub in Convor.
  2. Click Connect GitHub and approve GitHub authorization.
  3. Choose an available installation and click Use this installation. If needed, choose Install GitHub App in another account and grant access to the required repositories.
  4. Return to Convor and choose the default Repository.
  5. Click Save selection, then Check connection.

Convor generates short-lived installation tokens when needed. You do not need a personal access token.

Supported features

FeatureDescriptionStatus
GitHub App installationConnects a user or organization installationSupported
Repository discoveryLists repositories granted to the installationSupported
Default repositorySelects where new issues are createdSupported
Issue creationCreates issues with title, body, and optional labelsSupported
Short-lived authorizationGenerates installation tokens from the Convor GitHub AppSupported

Troubleshooting

  • Repository not listed: update the GitHub App installation and grant that repository.
  • Issue creation fails: confirm Issues are enabled and the app has access.
  • Installation belongs to another account: reinstall the app for the correct account or organization.
  • Access was suspended or removed: reconnect GitHub from Convor.

Disconnecting

Click Disconnect to remove this site's connection. The GitHub App stays installed, and other Convor sites keep their connections. To remove the app from the GitHub account or organization, uninstall it in GitHub after checking whether other Convor sites still depend on that installation. Existing issues remain.

Was this page helpful?

On this page