Skip to main content
All CollectionsIntegrationsAzure DevOps integration
Setting up Azure DevOps integration for your story map
Setting up Azure DevOps integration for your story map

Learn how you can setup Azure DevOps integration for your story map.

Tamás Párványik avatar
Written by Tamás Párványik
Updated over a week ago


StoriesOnBoard & Azure DevOps integration overview

Integrating your story map with an Azure DevOps project allows teams to plan more effectively, utilizing the visual power of story mapping to achieve transparency and shared understanding among stakeholders. Bring the team around to the story map to see the big picture and take advantage of real-time and bidirectional sync with Azure DevOps to keep everyone up to date at all time. The integration makes it possible to plan iterations on the story map and push cards to Azure DevOps for execution and keep your backlog in sync. With the powerful integration between StoriesOnBoard and Azure DevOps you can build and manage amazing products from the very beginning. This allows to do product discovery with user centric approach to build great products that users love.

Who can setup the Azure DevOps integration

You must have Admin role on the story map on StoriesOnBoard to be able to setup the integration with Azure DevOps. On the Azure DevOps side you must hold Admin rights as well.

How to setup Azure DevOps integration on your story map

  1. Open the story map

  2. Go to “Settings“

  3. Select “Integration settings”

  4. Select "Azure DevOps"

  5. Proceed with "Go to Integration Settings in Classic view"

  6. Select "Azure DevOps Services (previously Visual Studio Team Services)" option

  7. Enter your "Azure DevOps account URL"

  8. Complete the authentication

  9. Select your Azure DevOps project that you want to integrate with your story map

  10. Save changes

Step-by-step guide to link your story map to an Azure DevOps project

Open your story map and navigate to "Settings" then select "Integration settings".

Select "Azure DevOps", then click on "Integration Settings". We will redirect you to our Classic interface to setup the integration. Once it is done, you can return to the NextGen interface.

Select "Azure DevOps Services (previously Visual Studio Team Services" as a tool to integrate with.

Enter your Azure DevOps URL. It should be something like these examples:

Please do not include the project name in the URL.

Upon successful connection, you will be able to select your Azure DevOps project you wish to connect to your story map. Then simple select "Link project".

To complete the integration "Save" your settings.

How to access integration settings

StoriesOnBoard currently provides two interfaces to manage your story maps. These are the Classic and NextGen story map interfaces. Currently, you can only access integration settings for Azure DevOps if you navigate to Classic.

Integration settings on Classic interface

Integration settings on NextGen interface


In case you receive the error message below when you try to connect Azure DevOps, you need to change your settings in order to make this work.

If you receive the error message below these are the following things you need to check:

  • Not valid Azure DevOps workspace URL (do not include the project name)

  • OAuth issue (Third-party application access via OAuth is disabled)

  • Not holding the right access level (you are not a project admin)

  • You are a project admin but you do not have the rights (enable Edit project level info and View project level)

To resolve this issue, open your Azure DevOps and visit Organization Settings go to Security and select Policies. Make sure that Third-party application access via OAuth is enabled.

To resolve user rights issue, open your Azure DevOps and visit Project Settings > Permissions and select Project Administrators. Then enable "Edit project level info" and "View project level".

Learn more about:

Did this answer your question?