> For the complete documentation index, see [llms.txt](https://docs.oobeya.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oobeya.io/integrations/all-integrations/scm-addons/azure-devops-integration.md).

# Azure DevOps Integration

{% hint style="info" %}
Oobeya **Azure DevOps addon** is compatible with both Azure DevOps Services (cloud) and Azure DevOps Server (TFS2017, TFS2018, TFS2019).
{% endhint %}

## **1. Create Azure DevOps Personal Access Token**

1\. Navigate to **User Settings** and click **"Personal Access Tokens"**. 

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FhmDVE5PtAmUpx0mUOg2i%2Ffile.png?alt=media)

2\. Click the ***"New Token"*** button and select ***read*** permissions for the connection. 

The required permissions are:

* Build – *Read*
* Code – *Read* 
* Project and Team – *Read* 
* Pull Request Threads – *Read*
* Release – *Read*
* Test Management – *Read* 
* Work Items – *Read* 

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FnK8bOYmMxQfrGHpgDJbL%2Ffile.png?alt=media)

3\. Copy and save the *access token* to use it on the Oobeya data source connection.

## **2. Install Azure DevOps Addon on Oobeya** :jigsaw: 

1. Log in to [Oobeya](https://oobeya.io/) with an *Administrator* account.
2. Navigate to **Integrations** and select the **Azure DevOps** addon and then click the **"Install"** button. 

![](/files/YRw5y235Eu1XxTBzZQIY)

## **3. Add A New Data Source** :electric\_plug: 

1.Navigate to **Data Sources**, select Azure DevOps to add a new data source. 

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FXV9PrLMKFQrLNfJNFUwl%2Ffile.png?alt=media)

2\. Click the **"New Data Source"** button and fill in the form using the Personal *Access Token* which was created on Azure DevOps settings in the first step. 

**Data Source Name:** A custom name for your data source (e.g., "Oobeya Azure Data Source"). 

**Server URL:** Your Azure DevOps organization’s URL (e.g., <https://dev.azure.com/{your-organization})&#x20>;

**Token:** The Personal Access Token you retrieved earlier.

<figure><img src="/files/p2Qmgff1WmJjKU3qtfAh" alt=""><figcaption></figcaption></figure>

3\. Click the **"Test Connection"** button to verify the connection.

## **Ready to Connect** :rocket:&#x20;

Now Oobeya is connected with your own Azure DevOps to get the real-time statistics of your code repositories to track each development activity.

## **Next Steps** :dart:&#x20;

* [Add a new Widget](/dashboards/adding-a-new-widget.md)
* [Create a new Gitwiser Analysis](/gitwiser-repo-analytics/settings-for-git-analytics/initialize-development-analytics.md)