Skip to content
Knowledge base

Connect Azure DevOps

A personal access token with Work Items (Read & write) on one organization and project.

1. Create the token

In Azure DevOps, User settings > Personal access tokens: scope it to the organization, with Work Items set to Read & write, and pick the shortest expiry that fits your rotation. It is sent as a PAT (Basic auth with no username), the scheme Azure DevOps documents for scripts.

2. Add the connection

Tracker Azure DevOps, organization/project (e.g. acme-corp/Checkout), and the token. The optional work item type field defaults to Bug; set it to Task, Issue or whatever type your project actually has if Bug does not exist there.

3. Test, then file

Test connection reads that work item type in the project and fails clearly if the type name is wrong. Tickets are created with the title, a plain-HTML description (Azure DevOps renders System.Description as rich text, not markdown), and the realuptime label plus your defaults joined into the semicolon-separated Tags field.

Go deeper

The full reference lives in the docs: API documentation. Error codes named above are each explained in the error-code reference.