GitHub

Turn issues and pull requests into tasks.

Nic Riedel avatar
Written by Nic Riedel
Updated over a week ago

With our GitHub integration, you can keep track of issues and pull requests as tasks in Superlist.

Please note: To set up this integration you need to be a repository admin, since you need to have the necessary permissions to creates webhooks.

Connect your GitHub account

You can connect multiple GitHub accounts to Superlist. Here’s how:

  • Click on Settings and navigate to Integrations.

  • Locate GitHub in the list and click Configure.

  • Select Connect account and a new window will open.

  • Click Authorize Superlist.

  • Confirm access to your GitHub account by clicking Authorize superlistapp.

Create tasks from GitHub

Superlist automatically creates tasks when your review is requested on a pull request or when an issue is assigned to you. You can enable or disable these options from your integration settings.

Tasks added from GitHub will include:

  • The GitHub icon, so you can quickly identify the source. Clicking on the icon will take you to the original issue or pull request.

  • The title as the task title.

  • The description in the task details.

  • Dedicated labels for GitHub, the repository, and whether the task is related to an issue or a PR, so that you can find and filter tasks.

All tasks created from GitHub will appear in your inbox. Just like with other tasks, you can update the due date, labels, assignee, and details, and drag them into other lists.

Manage issues and pull requests from Superlist

Superlist tasks will stay in sync with activity in GitHub. Here are a few important things to know:

  • Automated comments about the activity of an issue or pull request will be added to the task’s messages.

  • Comments added by GitHub users will be added to the task’s messages. Similarly, messages added by Superlist users will be added to the relevant issue or pull request in GitHub.

  • After you’ve reviewed a pull request — or if the pull request is closed, merged, or converted to a draft — the task will be marked as complete. Reopening the pull request or additional requests for reviews will reopen the task in Superlist.

  • After an issue is closed — or if you’re unassigned from an issue — the task will be marked as completed. Reopening the issue or being reassigned will reopen the task in Superlist.

Disconnect a GitHub account

Connected accounts will appear at the top of the GitHub configuration page. To remove an account, simply click the Disconnect button to its right. Any current tasks created from that account will remain in Superlist, but new tasks will not be created and updates to existing ones will not sync with GitHub.

Did this answer your question?