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
-
From the Jira admin settings, go to Marketplace apps.
-
Expand Azure DevOps and select Work Items Sync.
-
Open the Integrations tab and select Create new integration.
Step 2. Choose a direction and connect Azure DevOps
-
Select the direction this integration is for: Jira to Azure DevOps, Azure DevOps to Jira, or Both directions. Each direction needs different token scopes (see below), so you may want a separate integration per direction.
-
Enter the Azure DevOps organization name for the project you'll be syncing.
-
Enter the Azure DevOps Personal Access Token.
Required Personal Access Token scopes
|
DIRECTION |
REQUIRED SCOPES |
|---|---|
|
Jira to Azure DevOps |
|
|
Azure DevOps to Jira |
|
|
Both directions |
|
|
Either direction, to map users org-wide instead of just project members (optional) |
also include |
User mapping works from your Azure DevOps project team membership by default - no additional scope is required for that. The Member Entitlement Management: Read scope above is optional, and only needed if you want to map users from anywhere in the organization rather than just the project's team.
Step 3. Scope, name, and test the connection
-
Select the Jira spaces this integration can access.
-
Give the integration a descriptive name.
-
Select Test Connection to validate it.
-
Select Save.
Related guides
-
Work Item Sync (overview)
Updated: September, 2026