{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Azure DevOps Boards Ticketing Provider Configuration Guide","siteUrl":"https://docs.synqly.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide provides step-by-step instructions for configuring the Azure DevOps Boards ticketing integration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Azure DevOps Boards uses Personal Access Tokens (PATs) for API authentication."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":0},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An Azure DevOps organization with at least one project"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An Azure DevOps account with permissions to create Personal Access Tokens"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-generate-a-personal-access-token","__idx":1},"children":["1. Generate a Personal Access Token"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sign in to your Azure DevOps organization at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.azure.com/{your-organization}"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Settings"]}," icon (gear) in the top-right corner and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Personal access tokens"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ New Token"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the token:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]},": Give it a descriptive name (e.g., \"Ticketing Integration\")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization"]},": Select your organization"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expiration"]},": Choose an appropriate expiration period"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scopes"]},": Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom defined"]},", then enable:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Work Items"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read & write"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vso.work_write"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]}," and copy the token value. Store it securely — you won't be able to see it again."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-gather-configuration-details","__idx":2},"children":["2. Gather Configuration Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You will need the following information:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Base URL"]},": The Azure DevOps API base URL (default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.azure.com"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization"]},": Your Azure DevOps organization name (the segment after ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dev.azure.com/"]}," in your URL)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project"]},": The Azure DevOps project name to scope work item queries to"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-configure-the-integration","__idx":3},"children":["3. Configure the Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create your integration by supplying the following values:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base URL for the Azure DevOps API (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.azure.com"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Azure DevOps organization name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["project"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Azure DevOps project name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credential"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Personal Access Token created in Step 1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["default_issue_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Default work item type for ticket creation (e.g., \"Task\", \"Bug\", \"Issue\"). Available types depend on the process template configured for your project — navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project Settings"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Boards"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Work item types"]}," to view them."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]}]}]}]}]},"headings":[{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"1. Generate a Personal Access Token","id":"1-generate-a-personal-access-token","depth":2},{"value":"2. Gather Configuration Details","id":"2-gather-configuration-details","depth":2},{"value":"3. Configure the Integration","id":"3-configure-the-integration","depth":2}],"frontmatter":{"slug":"guides/provider-configuration/azuredevops-ticketing-setup","seo":{"title":"Azure DevOps Boards Ticketing Provider Configuration Guide"}},"lastModified":"2026-07-15T14:26:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/azuredevops-ticketing-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}