Azure DevOps

You can integrate your TeamRetro team with your Azure Project, to automatically publish team actions items as Azure work items. To configure this integration you must be a TeamRetro team administrator.

Create personal access tokens to authenticate access

  1. Sign in to your Azure DevOps organization
  2. Click on your profile picture in the top right hand side, and select SECURITY.My profile Team Services
  3. Select PERSONAL ACCESS TOKENS on the left hand side menu.
  4. Click + NEW TOKEN
    Select New Token to create
  5. Configure your token:
    1. Name your token: eg. TeamRetro
    2. Select the Azure Organization where you want to use the token
    3. Set the lifespan for your token: (we recommend setting to Custom Defined and 365 days)

    Enter basic token information

  6. Select the scopes for this token to authorize for your specific tasks. TeamRetro requires the following scopes:
    1. Work Items - Read, write, & manage
    2. User profile - Read
    3. Project and Team - Read
  7. Click CREATE
  8. When you're done, make sure to copy the token. You'll use this token as your password.
  9. Copy the token (a 48 character string) to your clipboard

Configure in TeamRetro

  1. On the TEAM > SETTINGS > INTEGRATION screen
  2. Click CONNECT next to Azure DevOps
  3. Enter your organization URL (eg.
  4. Enter the personal access token you copied in the previous step
  5. After a short delay, you should be able to select the Project and Azure Work Item Type you'd like TeamRetro to create for each action item (eg. Task).

Testing Your Integration

Back on your Team > Home screen, click the publish icon and you will see "Publish to Azure DevOps" as an option. After selecting, TeamRetro will create a new Work Item in Azure and display the Work Item ID on the card.

Still need help? Contact Us Contact Us