By integrating Azure DevOps with DX, you can analyze pull requests, repositories, and CI/CD workflow data. Please visit our schema explorer to see what data DX imports—note that DX does not read or access your source code.
DX provides three separate connectors—for Boards, Pipelines, and Repos—which must be configured independently with separate service accounts and API tokens in order to avoid rate limit issues.
Prerequisites
To connect ADO to DX, you need:
an ADO service account
personal access token (PAT)
Setup instructions
Step 1
Go to the Azure portal and create a service account in Microsoft Entra ID (formerly Azure Active Directory).
Then, assign the service account to an ADO organization and grant them permissions.
Links to Microsoft documentation:
Step 2
Log into ADO using the service account
Generate a Personal Access Token with the read permissions outlined below:
Connection Type | Permissions |
ADO Boards | Work Items (read), Graph (read), Identity (read), Project and Team (read), Release (read) and Task Groups (read). |
ADO Pipelines | Build (read), Graph (read), Identity (read), Project and Team (read), Release (read) and Task Groups (read) |
ADO Repositories | Code (read), Graph (read), Identity (read), Project and Team (read), Release (read) and Task Groups (read). |
ℹ️ We request the same base scopes for multiple connections since it allows each connection to work independently to get the core data for projects, teams etc.
Step 3
Navigate to the connector setup form in DX.
Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.
Errors
The table below lists potential error codes when adding a connection in DX.
Error | Description |
| Your API credentials entered are not valid. |
| Your API token does not have the permissions required by DX. |
| Your service account does not have access to any projects or repositories. |