This guide provides step-by-step instructions for configuring the Azure DevOps Boards ticketing integration.
Azure DevOps Boards uses Personal Access Tokens (PATs) for API authentication.
- An Azure DevOps organization with at least one project
- An Azure DevOps account with permissions to create Personal Access Tokens
- Sign in to your Azure DevOps organization at
https://dev.azure.com/{your-organization}. - Click on the User Settings icon (gear) in the top-right corner and select Personal access tokens.
- Click + New Token.
- Configure the token:
- Name: Give it a descriptive name (e.g., "Ticketing Integration")
- Organization: Select your organization
- Expiration: Choose an appropriate expiration period
- Scopes: Select Custom defined, then enable:
- Work Items → Read & write (
vso.work_write)
- Work Items → Read & write (
- Click Create and copy the token value. Store it securely — you won't be able to see it again.
You will need the following information:
- Base URL: The Azure DevOps API base URL (default:
https://dev.azure.com) - Organization: Your Azure DevOps organization name (the segment after
dev.azure.com/in your URL) - Project: The Azure DevOps project name to scope work item queries to
Create your integration by supplying the following values:
| Field | Description | Required |
|---|---|---|
url | Base URL for the Azure DevOps API (e.g., https://dev.azure.com) | Yes |
organization | Azure DevOps organization name | Yes |
project | Azure DevOps project name | Yes |
credential | Personal Access Token created in Step 1 | Yes |
default_issue_type | 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 Project Settings → Boards → Work item types to view them. | No |