Skip to main content
All CollectionsIntegrationsJira integration
How to set up Jira Cloud integration with StoriesOnBoard
How to set up Jira Cloud integration with StoriesOnBoard

Learn more about the process of setting up Jira Cloud integration with StoriesOnBoard.

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

Contents:

StoriesOnBoard & Jira integration overview

Integrating your story map with a Jira 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 Jira to keep everyone up to date at all time. The integration makes it possible to plan releases on the story map and push cards to Jira for execution and keep your backlog in sync.With the powerful integration between StoriesOnBoard and Jira 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 Jira integration

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

How to set up Jira Cloud integration

  1. Click on your user menu

  2. Select the "Jira integration settings" option

  3. Select your Jira site if you have more than one and authenticate

  4. Configure a webhook

    1. Option 1 - Manual webhook configuration

    2. Option 2 - Automatic webhook configuration

  5. Once the webhook is successfully configured you can create your story map and link it to your selected Jira project.

The webhook will enable the real-time and bidirectional integration between your story map and teh Jira project to keep everyone updated.

Step-by-step guide to set up Jira Cloud integration

Navigate to your settings then select "Jira integration settings".


Proceed with the "Jira Cloud" option.


Authenticate your account. If you have more than one Jira site, select the one you want to connect to StoriesOnBoard and click on "Accept".

In the next step, you have two options for setting up a webhook:

  • Option 1 - Manual webhook configuration

  • Option 2 - Automatic webhook configuration

🤖 Automatic webhook configuration for Jira

If you want to proceed with the automatic webhook configuration, select the "Please set it up for me" option.

Once the webhook is configured, you can move forward to create your story map and connect it to your selected Jira project by following these steps on the story map:

If you wish to setup your webhook manually, keep follow our guide below.

Manual webhook configuration for Jira

To setup the webhook manually, open Jira's Webhook management here.

You will need to create a webhook and follow the instructions on your screen as below:

Once you opened the webhook management in Jira, proceed with the "Create a Webhook" option.

Copy the [ Name ] and [ URL ] from StoriesOnBoard into the relevant webhook fields in Jira.


Then scroll down to find the "Issue related events" section and enable the following fields:

  • created

  • updated

  • deleted

Then scroll further down to find the "Project related events" section and enable the following fields:

  • created

  • updated

  • deleted

To complete the webhook configuration select "Create" at the bottom of the screen.


Now you are ready to move forward to create your story map and connect it to your selected Jira project by following these steps on the story map:


Learn more about:

Did this answer your question?