How to use Azure DevOps with TheyDo

Once your Azure DevOps integration is active, you can push TheyDo solutions to your Azure DevOps backlog, keep statuses in sync across both tools, and track delivery progress from your journeys.

Overview

The Azure DevOps integration links TheyDo solutions to Azure DevOps work items. You can push solutions from TheyDo into a DevOps project, and have status changes flow back automatically using status mapping.

Pushing a solution to Azure DevOps

  1. Open the solution you want to push in TheyDo.
  2. Select Push to Azure DevOps.
  3. Choose the Azure DevOps project (your default project will be pre-selected if one is set).
  4. Choose the work item type.
  5. Confirm — the solution is now a work item in Azure DevOps, and the two are linked.

The work item ID will appear on the solution card in TheyDo once the link is created.

Keeping statuses in sync

When a work item's state changes in Azure DevOps, the linked TheyDo solution status updates automatically — as long as status mapping is configured.

You can set up status mapping in Settings > Integrations > Azure DevOps:

  • Use Project Rules to map statuses per project.
  • Use Bulk Update to apply mappings across all projects at once.

Two-way sync for titles and descriptions

If two-way synchronization is enabled, changes to the title or description in Azure DevOps will also update the linked solution in TheyDo.

Keep two-way sync off if you want TheyDo to remain the source of truth for solution details.

Resyncing projects

If you've added new Azure DevOps projects or your project list has changed, use the Resync button in Settings > Integrations > Azure DevOps to refresh the project list. The integration will briefly show Syncing, then return to Active.

Monitoring connection status

Check the connection status at any time from Settings > Integrations:

  • Active — the integration is healthy
  • Installing — setup is still completing
  • Syncing — a data sync is running
  • Error — something needs attention (you may need to re-authenticate with a new PAT)

Tips

  • Multiple TheyDo workspaces can connect to multiple Azure DevOps projects.
  • If your PAT expires, the integration will enter an error state. Re-authenticate with a new token from the integration settings page.
  • Updating the default project or two-way sync toggle requires organization admin permission.