Azure DevOps for Jira
Azure DevOps for Jira
Breadcrumbs

Setting up a Work Item Sync Integration

Before you can sync work items between Jira and Azure DevOps, set up an integration - the connection and credentials both sync directions rely on.

Step 1. Open the integrations screen

  1. From the Jira admin settings, go to Marketplace apps.

  2. Expand Azure DevOps and select Work Items Sync.

  3. Open the Integrations tab and select Create new integration.

    image-20260829-025138.png

Step 2. Choose a direction and connect Azure DevOps

  1. Select the direction this integration is for: Jira to Azure DevOps or Azure DevOps to Jira. Each direction needs different token scopes (see below), so you may want a separate integration per direction.

    image-20260829-025254.png

  2. Enter the Azure DevOps organization name for the project you'll be syncing.

    image-20260829-025706.png


  3. Enter the Azure DevOps Personal Access Token.

    image-20260829-025730.png

Required Personal Access Token scopes

DIRECTION

REQUIRED SCOPES

Jira to Azure DevOps

Work Items: Read & Write

Azure DevOps to Jira

Work Items: Read, Project and Team: Read & Write

Either direction, if you'll use User Mapping

also include Identity: Read & Manage

Step 3. Scope, name, and test the connection

  1. Select the Jira spaces this integration can access.

    image-20260829-025834.png


  2. Give the integration a descriptive name.

    image-20260829-025908.png


  3. Select Test Connection to validate it.

    image-20260829-025956.png

  4. Select Save.

    image-20260829-030036.png

Updated: August, 2026