---
title: Azure DevOps Integration
description: Learn how to connect your Azure DevOps repositories to Capawesome Cloud to build and automate your app directly from source.
---

# Azure DevOps Integration

Connect your Azure DevOps repositories to Capawesome Cloud to build and automate your app directly from source. A Git connection stores your provider and credentials once at the organization level and can be reused by any app in that organization.

## Prerequisites

Before you begin, ensure you have:

- A [Capawesome Cloud](https://console.cloud.capawesome.io){:target="_blank"} account and an organization (owner or admin role to manage Git connections).
- An Azure DevOps account with access to the repositories you want to connect.

## Create a Git connection

A Git connection is created once at the organization level and can be reused by every app in that organization.

1. Open your organization's [Git connections](https://console.cloud.capawesome.io/organizations/_/git){:target="_blank"} page and click **Create Git connection**.
2. Select **Azure DevOps** as the provider.
3. Follow the steps below to authenticate with a personal access token.

### Personal access token (PAT)

Paste a token you create on Azure DevOps.

1. Create an Azure DevOps personal access token for your organization with **Custom defined** scopes:
    - For a read-only connection: **Code (Read)**.
    - To enable [Automations](../automations/index.md): **Code (Read & write)** instead — it also covers managing the repository's service hooks (webhooks).
2. Select **Personal access token (PAT)** as the authentication method and paste the token.

!!! note "Organization-scoped tokens"

    Create the token for the specific organization you want to connect. Because organization-scoped tokens cannot list your organizations ([global tokens are retired as of December 2026](https://devblogs.microsoft.com/devops/retirement-of-global-personal-access-tokens-in-azure-devops/){:target="_blank"}), you enter the organization name manually when connecting a repository.

## Connect a repository to your app

Once a Git connection exists, connect a specific repository to your app:

1. Open your app's [Git repository](https://console.cloud.capawesome.io/apps/_/git){:target="_blank"} page and click **Connect Git repository**.
2. Select the Azure DevOps connection.
3. Select an organization (for personal access token connections, enter the organization name manually), then a project, and finally the repository you want to connect.

You can also connect a repository during **Create app** (on the **Git** tab).

## Troubleshooting

### Missing organizations

If an Azure DevOps organization does not appear when selecting a repository, ensure the personal access token or personal account has access to the right Azure DevOps organization. Each organization is tied to a specific Microsoft Entra tenant, so sign in with an account from the organization's home tenant, or attach the organization to your default directory.