Azure DevOps Services (VSTS) setup

Tags: Flow

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

Note: This integration is only for Azure DevOps Services (ADO Cloud). If you use Azure DevOps Server, follow the instructions for creating a TFS integration.

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. Click Settings In Flow's top navigation. 
  2. In the left navigation under Integrations, click Integrations.
  3. Click the Add Integration button in the top right corner of your integrations screen.
  1. On the following Integration provider page, click Azure DevOps.
  1. Select if you want to connect via OAuth or via Access token.
  2. 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.

Connect via OAuth

To connect to ADO via OAuth:

  1. Select the OAuth tab on the Select Authentication Method page. 
  2. Click Connect to Azure DevOps.
  3. Follow the prompts to sign into your ADO account.
  4. In ADO, select the organization you want to connect to Flow.
  5. Copy and paste the base URL from ADO into the Base URL field. Your URL will look like{yourorganization}.
  6. Click Test URL.
  7. On the following page, use toggles to select the available services you want ingested by Flow.
  8. Click Next. 
  9. Next, name the integration.
  10. Click Create.

Flow will take you to the new integration’s integration page and your integration will be listed on the Integrations page.

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
  1. On the Personal access token page, click New Token.
  1. 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
  1. 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.
  1. Click Test connection.
  1. 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.

  1. After connecting to your Azure DevOps account, click Next.
  1. On the next screen, choose which 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.
  1. Name the integration to identify the account you connected. Click Create.
  2. 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, import your 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, check your credentials.
    • If 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}
  2. 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 Support (opens email form) for 24/7 assistance.