A Guide To Unito's GitHub Integration Need to include GitHub in your workflow? Here's a list of the fields you can sync, customization options, and more.
Synced fields
Here are the fields you can currently sync with GitHub, whether they can be used in two-way flows, as well as whether you can use them in rules or not.
Most fields can be synced both ways. This means changes in one tool will affect the other and vice-versa. You can also edit a flow (or a specific field mapping) so that changes only go from one tool to the other and not back.
Customization options
Our GitHub integration supports a number of customization settings.
Syncing pull requests
Issues aren't the only work item you can sync to other tools. Unito's GitHub integration supports pull requests, too! You can't create new pull requests from another tool, but you can keep them in sync with an equivalent work item in another tool. Say you sync a GitHub pull request with a Trello card. Make a change in the Trello card, and it will be automatically synced to GitHub.
Note: Unito will never sync any changes to the code associated with a pull request. That means you don't have to worry about a Unito flow messing up your code.
GitHub marketplace support
There are two ways to use Unito's GitHub integration. You can either go through the standard authorization process through our standalone website, or you can go through GitHub's marketplace. The latter has a quicker authorization process, and you can choose with repositories you want Unito access instead of needing to provide blanket access.
Open-source repositories
You can sync open-source repositories with your other work management tool of choice. If you want to do so, there are a few things to keep in mind:
-
Assignees will only sync if they also exist in the other tool you've connected.
-
Unito considers anyone commenting or assigned to an issue in GitHub as an active user. Have a lot of open-source collaborators? Get in touch with us by clicking on the chat bubble!
GitHub On-Premise Enterprise support
If you're using GitHub's On-Premise Enterprise solution, you can still use Unito's integration. Note that some additional setup steps may be required.
Prefix task title with issue number
When syncing GitHub to other work management tools, you can have the GitHub issue added as a prefix to the task's title in your other tools.
Limitations and other things to keep in mind
We’re constantly looking to better support GitHub’s growing list of features, fields, and use-cases. Here are a few limitations you should be aware of:
-
Subtasks and checklists can't be synced by default since GitHub only supports parent tasks. That said, there is a workaround to achieve a similar result. Here's how it's done in Asana.
-
We don't support GitHub projects. Issues connected to both a repo and a project will continue to sync, but you can't select a GitHub project as a block of work.
-
GitHub labels can't be mapped with all other fields. It'll only work with similar fields, like tags in Asana or labels in Trello.
Things to keep in mind
Here are a few things to keep in mind when using our GitHub integration:
-
Unito needs certain read & write permissions in order to work. You can get a full breakdown of these permissions here.
-
In order for on-premise GitHub accounts to connect to Unito, it needs to be accessible via the internet. If that isn't the case, please read our guide to set this up, or contact us if you’re not sure how to proceed!
Necessary permissions
You need to both be a member of the organization that owns the repository you want to sync and a collaborator (which is different from a contributor). If your organization has enabled third-party application restrictions, you'll need to follow this step-by-step guide for approving third-party apps in GitHub.
In addition, we need the repository permission that includes “repository webhooks for public and private repositories” to create webhooks. We do not require the admin:repo_hook permission. You can get more information about these permissions here.
Most importantly, Unito will never ask for, or require access to, any code you have stored on GitHub.
Note: We can't sync a repository if it was forked from another repository.
OAuth Scopes
