Integrating Savah with Jira

How to setup 2-way Syncs between Savah and Jira.

Integrating Savah with Jira is a simple and seamless process. Savah uses Jira's REST API to fetch and update data. To enable two-way communication—Jira to Savah—you will also set up a webhook in Jira. Follow the steps below to complete the integration smoothly.

Creating a Jira Integration Account

In Savah, a Jira Integration Account is the bridge that connects your workspaces to Jira.

  • You can create multiple integration accounts.

  • Each workspace can be linked to one Jira Integration Account.

  • All program boards inside that workspace will inherit the same connection and access to linked Jira projects.

Ways to Create a Jira Integration Account

  1. From the Integrations Menu

    • Only Super Admins can access this

    • Go to the left menu and click on Integrations.

  1. During Workspace Creation or Edit

    • While setting up or editing a workspace, click + Integration to create or link an existing Jira account.

Once linked, all program boards under the workspace will be able to sync with Jira projects easily.


Connecting Savah to Jira Cloud

To establish the Jira Cloud connection, provide the following:

  • Account Name: A label to identify the integration (e.g., JIRA-Integration-1)

  • Jira URL: The full Jira URL (e.g., https://yourcompany.atlassian.net)

  • Username: Your Jira login email/username with API access

  • API Token: Required in place of a password


Generating an API Token from Jira

You need an API token to authenticate with Jira Cloud.

Steps

  1. Click Create API Token

  2. Enter a meaningful label (e.g., Savah Integration) and click Create

  3. Click Copy to Clipboard

  4. Paste the token into the Savah integration form


Linking Jira Projects to Integration Account

After creating the Jira Integration Account

  • Navigate to the Integration Account page

  • Link one or more Jira projects

  • Savah will fetch item creation metadata, including

    • Issue Types

    • Workflow Statuses

This ensures smooth two-way syncing between Savah and Jira when creating or updating items.


Re-Syncing Jira Projects

If changes are made in Jira (like new issue types or modified workflows), you'll need to resync the project in Savah.

How to Resync

  1. Go to Integrations > Jira Integration Accounts

  2. Select the relevant integration account

  3. Locate the Jira project and click Resync

Savah will then refresh and update

  • New Issue Types

  • Updated Workflow Statuses

Now you can create Epics and Stories on the Program Board that can be linked with Jira

Last updated