Get started guide for Microsoft Azure DevOps for Confluence for Confluence On-Premise administrators.

Here you can find a few use cases for this application

Use cases

Getting the personal access token

To connect your Confluence and Azure DevOps instances, we recommend you first obtain a Personal Access Token (PAT). You can use a service account to generate this PAT but do remember that Microsoft forces you to log in every 90 days to keep the PATs active.

The following steps will help you create a new Personal Access Token:

  1. Navigate to the User Settings in the right corner of the navigation menu.

  2. From the drop-down, select Personal access tokens.

  3. Click on the New Token button and generate a new personal access token with minimal scope. Currently, the App needs the token to read-only work items information and read-only access to the builds.

Alternatively, you can use this official guide from Microsoft.


Once you have got the Personal Access Token, you can proceed with the connection of Confluence and Azure DevOps instances:

  1. Move to the Confluence Administration section (“gear” button in the right corner of the navigation menu).

  2. Navigate to the Manage app page and on the right sidebar, find our application Azure DevOps.

  3. On the Global configuration page, enter your Personal Access Token and click Save. If the token has expired, you must create a new one and enter it here again.

  4. Instead of a button Save button, a Disconnect button appears.

  5. Optionally, you can indicate the Azure DevOps base URL (to use by default) and Azure DevOps organization (inserted in the macro), not to enter them in the macro. Those parameters you can change whenever you wish after the connection.


If you need to reconnect or disconnect the Azure DevOps Confluence Connector with your Azure DevOps instance, please:

  1. Navigate to the Global Configuration page.

  2. Unplug the App by clicking on the button Disconnect.