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.

## Prerequisites

- An Azure DevOps organization with at least one project
- An Azure DevOps account with permissions to create Personal Access Tokens


## 1. Generate a Personal Access Token

1. Sign in to your Azure DevOps organization at `https://dev.azure.com/{your-organization}`.
2. Click on the **User Settings** icon (gear) in the top-right corner and select **Personal access tokens**.
3. Click **+ New Token**.
4. 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`)
5. Click **Create** and copy the token value. Store it securely — you won't be able to see it again.


## 2. Gather Configuration Details

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


## 3. Configure the Integration

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 |