Set up
A walkthrough of the set up process when integrating Avion with Jira Cloud.
Last updated
A walkthrough of the set up process when integrating Avion with Jira Cloud.
Last updated
Before you dive in, please note that the user that you choose to authenticate with Jira Cloud must be a Jira Administrator and a Project Administrator. Avion will not let you proceed without these privileges. If these privileges are revoked after the integration is setup, you will get unexpected behaviour.
Here is a to enable these permissions.
For this reason, you might choose to create a specific integration user that can be controlled by a trusted member of your business. This mitigates against the situation where you have to delete a user that Avion is authenticated with if a person leaves your business. .
Select the project you wish to integrate with. Currently Avion supports a direct mapping of one or many story maps to one Jira project, although we recommend keeping it simple with a one to one mapping.
Here you can choose how you would like Avion to map to your Jira epics. It’s worth having a think about this decision, as it will change how the integration feels to work with on a day-to-day basis.
Select from all your issue types (not including your epic type or subtasks) and map one to Avion's stories.
Setting up a webhook means that every time a change is made in Jira, Avion is notified and can therefore update your story map. This is essential for a two-way integration.
Follow the prompts and Avion will automatically set up a webhook for you. If you already have webhooks for other story maps, please don't delete them. Each story map needs a unique webhook.
Please be aware that the API token you entered earlier in the process is used to create the webhook. So, if this stage fails, the issue is most likely that your API token was incorrect. The API token should not be your password.
If you would like more details about epic mapping, you can read our guidance here, .
Map your Avion to your Jira states. .
Import your backlog from Jira Cloud and even specify a JQL query to restrict what issues are imported, although this is not a requirement. .
