Skip to main content
Issue trackers are in preview and are enabled per organization. Ask your Datafold contact or support@datafold.com to turn them on.
Datafold files and updates Azure DevOps work items with the personal access token of a service account, not as you. One Azure DevOps project connects to one Datafold organization. Datafold supports Azure DevOps Services and Azure DevOps Server.

​
1. Create a service account and a token

1

Add a user for Datafold

In your Azure DevOps organization (or collection, on Azure DevOps Server), add a user for Datafold with Basic access. Stakeholder access cannot add the tags that Datafold uses to find its work items again.
2

Add it to the project

Add that user to the Contributors group of the project that Datafold will use.
3

Create a personal access token

Sign in as that user. Open User settings → Personal access tokens, and create a token for this organization with these scopes:
  • Work Items: Read & write
  • Project and Team: Read
  • Identity: Read (optional; lets Datafold @mention people in comments)
Copy the token. Azure DevOps shows it only once.

​
2. Connect Azure Boards in Datafold

Go to Settings → Integrations → Issue Trackers, click Add new integration, and choose Azure Boards. Fill in the form and click Connect:
  • Organization URL: the address of your organization, for example https://dev.azure.com/your-organization. On Azure DevOps Server, use the address of the collection, for example https://ado.example.com/tfs/DefaultCollection. The address must start with https://.
  • Project: the name of the Azure DevOps project.
  • Personal/Project Access Token: the personal access token from step 1.

​
Replace the token

If Azure DevOps refuses the token (it expired or was revoked), the page shows Azure DevOps refused the token. Create a new personal access token for the service account, enter it in the form, and click Update token.

​
Disconnect

Disconnect makes Datafold forget the token. Datafold cannot revoke it, so revoke the service account’s personal access token yourself in Azure DevOps. It stays valid until you do or until it expires.