This is a step-by-step guide for adding your repos with a cloud Git host via OAuth or access token.
Who can use this?
Important: We strongly recommend you use a service account to create this integration. Learn more about creating service accounts.
Connect to your Git Host
OAuth is available for GitHub, Bitbucket, and GitLab. OAuth is the fastest and easiest method to connect your repos and bring in all of your data, including pull requests and tickets.
Tip: To import repositories, you must be the owner or a collaborator in the org, group, or project in your Git host.
- Click Settings in the top navigation bar of Flow.
- In the left navigation under Integrations, click Integrations.
- Click Add Integration.
- Select the desired Git host from the Integration Provider list.
- Choose to connect your Git host via OAuth or Access Token.
Connecting through OAuth
OAuth is the simplest way to connect to your Git host.
To connect with OAuth:
- Choose the Git host
- Select the OAuth tab.
- Click Connect to GitHost
If you are already logged into your Git host, you will automatically be connected. If you are not logged in, you will be prompted to login and then you will be connected. Once you are connected, you will see a Success message.
If the connection was unsuccessful, you will see this error message: Authorization failed. Please double check your url and/or authentication credentials. Double check your credentials and try again, or connect via OAuth.
Tip: At this time two factor authentication is not supported via username and password. If your account has two-factor authentication enabled you will need to use an access token as your password.
Connecting through an access token
You can also connect to your Git host via an access token. This option is available for GitHub and GitLab. On the Access Token tab, input your access token and click Test connection.
Once you have successfully connected to your Git host, click Next.
On the next screen, select the services you want for this integration. If you would like Flow to ingest ticket data and pull request data in addition to repo data, then leave all three services on. You can turn services on and off at any time. Click Next.
Name your integration so you can identify the account you connected with. In this example we named it “Robert’s GitHub”. Click Create.
Access Token Permissions
Access Token Permissions
You may need to create an access token. When creating your access token, you will need to select setting permission. Please see our recommended access token permissions below.
After Connecting to your Git Host
If the connection was successful you will see a success message.
Once you are connected, you can import your repos by going to your repo import page. Click the repo import page link. To learn more about managing your new integration settings, see Managing integrations.
If you need help, please email Support (opens email form) for 24/7 assistance.