# 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. 

![](https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FlpPez5GJHWlYExa8WnX4%2FScreenshot%202024-12-13%20at%2016.33.15.png?alt=media\&token=3af0c599-dc16-4a9c-b0ed-6ee720b12f9c)

## **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="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FWMjzEK5n4zCkv2X3bxK9%2Fimage.png?alt=media&#x26;token=88ca0d3a-3b42-4028-be34-2ba18f4eccd9" 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](https://docs.oobeya.io/dashboards/adding-a-new-widget)
* [Create a new Gitwiser Analysis](https://docs.oobeya.io/gitwiser-repo-analytics/settings-for-git-analytics/initialize-development-analytics)