How to Integrate zipBoard with Jira (Setup, Status Mapping and Troubleshooting)

To integrate zipBoard with Jira, connect your Jira Cloud or Jira Server account to your zipBoard organization, then map a zipBoard project to a Jira project. Every task created in zipBoard is then added to Jira automatically. This guide covers setup, status and priority mapping, linked issues, editing, removal and troubleshooting.

What does the zipBoard Jira integration do?

When you integrate a zipBoard project with a Jira project, all issues created in zipBoard by any collaborator are automatically added to and updated in the mapped Jira project, and a link to the Jira issue appears in the zipBoard task. You keep the workflow you already follow in Jira; zipBoard makes the feedback visual rather than lines of text.

The Jira integration requires a subscription to zipBoard's Team plan or above. Visit Pricing.

Why integrate zipBoard with Jira? Watch this video:

Does zipBoard support two-way sync with Jira?

Yes. When someone changes a linked issue in Jira, the change also appears in the zipBoard task. These fields are mapped between the two tools:

Assignee
Priority
Due date
Type
Replies
Description

Keep these limitations in mind:

Comments you add in zipBoard show in Jira as posted by zipBoard, with your username.
Status changes made in Jira may not be reflected in zipBoard. See status and priority mapping below.
Tasks imported from CSV are not sent to Jira by default. See Why aren't imported tasks in Jira?

To receive updates from Jira in real time, enable webhooks.

How do I set up the Jira integration?

Connect Jira once at the organization level, then map each zipBoard project to a Jira project. You must be a Project Owner in zipBoard and an Administrator in Jira.

Go to Manage org and select Integration.
Choose your Jira application type. Jira Cloud and Jira Server use different login processes, described below.

How do I connect Jira Cloud?

Create an Atlassian API token first, then add your Jira site in zipBoard.

Go to the Atlassian API tokens page and click Create API token.
Give the token a label of your choice, click Create, and copy the generated token.
In zipBoard, choose the Jira Cloud integration, add your Jira site, and accept.
Enable the webhook: enter your email and the API token, then click Save.

How do I connect Jira Server?

Click Server, enter your Jira URL, username and password, then click Connect.

How do I enable webhooks to receive updates from Jira?

Webhooks are optional and let zipBoard receive real-time updates from the Jira issues it created. Turn them on after you authenticate Jira.

Create an API token on the Atlassian API tokens page.
On the Integrations tab, click Enable webhook.
Enter your email and the API token, then click Save.

If you delete the Jira authentication and add it again, enable the webhook again. The earlier webhook is deleted.

What do I do after connecting Jira to my organization?

Map each zipBoard project to the Jira project its issues should go to. Once Jira is connected, a list of all projects associated with the Jira account loads.

In zipBoard, go to the project settings and click the Jira icon.
Choose the Jira project that issues created in zipBoard should go to.
Map how Bugs and Enhancements in zipBoard should appear in Jira.
Click Save to enable the integration.

From now on, all tasks created in zipBoard by any collaborator are added to the mapped Jira project, and a link to the Jira issue appears in the zipBoard task.

How are statuses and priorities mapped between zipBoard and Jira?

zipBoard's default statuses are mapped to Jira statuses as shown below. Priority is one of the fields kept in sync between the two tools.

If you add custom task statuses, zipBoard prompts you to map them to your Jira statuses, and to map Jira statuses back to zipBoard statuses. See How to map newly created statuses with Jira and Wrike integrations.

Custom task statuses and mapping them to integrations are for zipBoard Enterprise users.

How do I view the linked Jira issue for a zipBoard task?

Click the Jira issue link in the zipBoard task to open the matching Jira issue. You can switch back the same way.

From zipBoard: open the task and click the Jira issue link.
From Jira: click the zipBoard task URL in the issue description to open the linked zipBoard task.
From project settings: open the linked Jira project from the zipBoard project settings tab.

How do I edit the Jira integration settings?

Click the edit Jira icon under the project settings, change the fields you need, and click Save so your changes apply.

To refresh the organization's connection to Jira instead, see How Do I Re-authenticate my Jira Integration.

How do I remove the Jira integration?

You can unlink a single task, a whole project, or your whole organization from Jira.

One task: in the task, click the delete icon next to the Jira issue ID.
One project: in the project settings, click the delete icon under the Jira integration.
The whole organization: on the organization's integration page, click the delete button next to Jira.

Jira integration troubleshooting and FAQ

Why do I get an "Unable to authenticate" error when connecting Jira?

This error usually means the credentials or the Jira instance cannot be reached. Check the following:

You entered the correct Jira URL, username and password.
The Jira credentials belong to a Jira Admin account.
The username field contains your Jira username, not your email address.
If you sign in to Jira Cloud with Google (G Suite), use your Atlassian password, not your Google password. This Atlassian Community thread explains how to find it.
Your Jira instance is not behind a firewall.

If your connection stopped working after it was set up, re-authenticate your Jira integration. If you still can't authenticate, email support@zipboard.co and we'll help you troubleshoot.

Can I see error logs for the Jira integration?

Yes. Once your organization is integrated with Jira, you can view any integration errors.

Go to Manage Integration.
Click Error logs. The error logs are shown.

If you have questions about an error, email support@zipboard.co.

Why aren't imported tasks in Jira?

Tasks you import from CSV are not sent to Jira by default. To send one, click the + icon beside the Jira integration in the task.