Below is a step-by-step guide for adding your repos with OAuth.
Who can use this?
Important: We strongly recommend you use a service account to create this integration. Please see this article for instructions to create a service account and read more about why service accounts are important here.
Connect to your Git Host
OAuth is available for GitHub, Bitbucket, and GitLab—this is the fastest and easiest method to connect your repos and bring in all of your data including pull requests and tickets.
Tip: You must be either the owner or a collaborator in the org, group, or project in your Git host in order to import repositories.
- Starting on your Flow home page, go to the top navigation bar and click Settings. Using the left navigation under Integrations, click Integrations.
- Click Add Integration.
- On the following page, select the desired Git host from the Integration Provider list and click Next.
- Next, choose one of two ways to connect your Git host: OAuth or Access Token. Learn more about these connection methods below.
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 firstname.lastname@example.org for 24/7 assistance.