← All docs

Connecting Azure DevOps Boards

An alternative trigger to Jira, for teams already tracking work in Azure Boards.

What you need

  1. Your organization name (from dev.azure.com/acme)
  2. The project name
  3. A personal access token with Work Items: Read & write

Tags, not labels

Azure DevOps has no separate labels field — the trigger label is matched against System.Tags, a single semicolon-separated string every work item already has. Add your trigger label to that field the same way you'd add any other tag.

Set it up

  1. Connectors → Add connector → Azure DevOps Boards
  2. Enter the organization and project, and paste the personal access token
  3. Click Test connection — it shows the project's id and state
  4. In Azure DevOps: Project Settings → Service Hooks → Web Hooks, subscribed to Work item created and Work item updated, pointed at the URL shown on the connector's card

What gets written back

One comment on the work item once the pipeline finishes — root cause, the PR link, and whether CI passed.