Azure DevOps (VSTS) setup

Tags: Flow

Follow this step-by-step guide to connect your Microsoft Azure DevOps to Flow.

Before getting started, make sure your system is supported. Git repos are supported. TFVC repos are not supported. 

Permission requirements

There are two requirements to use integration services such as repos, pull requests, tickets and webhooks:

  1. Set up personal access token scopes. Follow the instructions below to learn more. 
  2. Make sure the service account is set up as a Project Collection Administrator at the organizational level.
  3. Your git host may not require webhooks. If this is the case, set the git host’s View instance-level information permission to Allow. This permission is required  to establish a connection and import repos. Add the user to the reader group at the project level.

Azure DevOps configuration

Follow these steps to set up your Azure DevOps configuration.

  1.  First create a new integration.Starting on your Flow home page, go to the top navigation bar and click Settings. Using the left navigation under Integrations, click Integrations.
  2. Click the Add Integration button in the top right-hand corner of your integrations screen.
  3. On the following Integration provider page click Azure DevOps.
  4. Input your email address, Personal access token, and Base URL. Use the exact email format seen in your Azure user profile. The email field is case sensitive. Your URL will look like{yourorganization}.

    Note: Use the domain in the Base URL field in Flow to connect successfully. This applies even if your base URL in Azure Devops uses the domain.

Creating a personal access token

Follow the instructions below to create a personal access token in Azure DevOps.

  1.  Locate Personal access tokens under your user settings

  2. On the Personal access token page click, New Token.

  3. Fill in the following information for your new personal access token:

    • Name
    • Organization 
    • Expiration date
    • Scopes - Below find the minimum scopes required to connect your account.
      • Code: Read
      • Build: Read
      • Graph: Read
      • Identity: Read
      • Project and Team: Read
      • Work Items: Read
  4. Click Save.

Finalizing the connection

After creating a personal access token, complete your integration setup in Flow.

  1. Copy your access token and paste it into the Flow Personal Access Token field. 

  2. Click Test connection.

  3. If the connection is successful you will see the following message:

    If you receive an Authorization denied error when trying to connect your Azure DevOps account, verify the access token and try again.

    If you receive An error has occurred error, verify the email and base URL are correct and try again. 

  4. After connecting to your Azure DevOps account, click Next.

  5. On the next screen select the services to turn on for this integration. To import pull request and ticket data in addition to repo data, leave all services on. You can turn services on and off at any time. Click Next.

    Note: Azure DevOps Work Items are generally mapped to Tickets in Flow.
  6. Name the integration to identify the account you connected. Click Create.
  7. You can begin to 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 Manage integrations.

Import repos

After creating  the Azure Devops integration, you are ready to import repos. Begin importing repos by  going to your repo import page. Click the repo import page link. To learn more about managing your new Integration settings, see manage integrations


Follow these troubleshooting steps if you are having trouble connecting your integration. 

  1. If your Integration does not test successfully, you may need to check your credentials.
  • Check to make sure your email address is the same case and spelling as seen in your Azure Profile. The email field is case sensitive.
  • Review the scopes in your access token to ensure all required scopes have been selected. 
  • Confirm your base URL adheres to the required format:{yourorganization}
  1. If you’re unable to enable Webhooks, check your Azure user permissions. In order to enable webhooks, you must be a Project Collection Administrator.  

back to top

If you need help, please email for 24/7 assistance.