> For the complete documentation index, see [llms.txt](https://docs.pharos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pharos.ai/configuration-guide/integrations/azure.md).

# Azure

Configure the Azure DevOps integration in Pharos Admin for automated work item creation and status synchronization.

The Azure DevOps integration connects Pharos to your Azure DevOps organization for automated and manual work item creation. Once authenticated, you can create work items directly from Pharos issues, set up [ticketing rules](https://docs.pharos.ai/configuration-guide/ticketing/rules.md) for automation, and synchronize status between the two systems.

Azure DevOps uses OAuth authentication via Microsoft Entra ID (the same Pharos.ai application used by the [Teams integration](https://docs.pharos.ai/configuration-guide/integrations/teams.md)). See the Teams article for detailed consent scenarios if you encounter approval prompts.

{% hint style="info" %}
For what the Azure DevOps integration sends outside your org and the access it requires, see [Security & Data Access](https://docs.pharos.ai/configuration-guide/security.md).
{% endhint %}

***

## Settings

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🔑 Azure — Authentication</strong></td><td>Set up authentication between Pharos and Azure DevOps.</td><td><a href="https://docs.pharos.ai/configuration-guide/integrations/azure/authentication.md">Authentication</a></td></tr><tr><td><strong>⚙️ Azure — Defaults</strong></td><td>Configure default synchronization and work item behavior for the integration.</td><td><a href="https://docs.pharos.ai/configuration-guide/integrations/azure/defaults.md">Defaults</a></td></tr></tbody></table>

***

## Prerequisites

| Requirement                   | Details                                                                                       |
| ----------------------------- | --------------------------------------------------------------------------------------------- |
| **Azure DevOps organization** | An active Azure DevOps instance with at least one project                                     |
| **OAuth access enabled**      | Organization Settings → Policies → "Third-party application access via OAuth" must be **On**  |
| **Admin or user consent**     | Depending on your Entra ID configuration, admin consent may be required for the Pharos.ai app |
