Azure DevOps integration

Connect TheyDo to Azure DevOps to sync solutions with your work items. This keeps your journey management and delivery pipeline aligned — without manual updates.

Before you start

  • You need integration-management permission in TheyDo.
  • You'll need your Azure DevOps organization URL and the ability to create a Personal Access Token (PAT) with the right permissions.

How to set up the Azure DevOps integration

Step 1: Enter your organization name

  1. Go to Settings > Integrations in TheyDo.
  2. Find Azure DevOps under Product integrations and select Enable.
  3. Enter your Azure DevOps organization name — for example: https://dev.azure.com/yourorganization.
  4. Click Authorize.

Step 2: Create a Personal Access Token

  1. TheyDo will provide a direct link to your Azure DevOps token settings page.
  2. In Azure DevOps, create a new PAT with the following scopes:
    • Notifications: Read
    • Work Items: Read & Write
  3. Copy the token and return to TheyDo.
  4. Paste the token into the Personal Access Token field.
  5. Click Authorize integration.

TheyDo will validate the token immediately. If the connection is successful, you'll see a confirmation and the integration will move to Active.

If you see an error, double-check that your organization URL is correct and that the PAT scopes are set correctly.

Configure synchronization settings

Once connected, you can configure how TheyDo and Azure DevOps work together.

Note: Changing synchronization settings requires organization admin permission.

Default Azure DevOps project

Set a default project to push solutions to. You can always change the project when pushing individual solutions.

Two-way synchronization

Toggle this on to sync title and description changes from Azure DevOps back to TheyDo.

Map statuses

Status mapping lets you define how Azure DevOps work item states map to TheyDo solution statuses.

Per-project mapping:

  1. Use the Project Rules tab to map statuses for individual projects.
  2. Select the Azure DevOps project and link each work item state to a TheyDo status.

Bulk update:

Use the Bulk Update tab to apply global status mappings across all connected projects at once. You can still override specific projects using Project Rules afterwards.

Resyncing projects

Azure DevOps has a manual Resync button to re-import projects and pick up any changes (such as new projects or deleted ones). Click Resync from the integration page — the status will briefly show Syncing, then return to Active.

Token expiration

If your PAT expires, the integration will enter an error state. The page will prompt you to Re-authenticate with a new token. This only requires integration-management permission.