Search documentation...

K
ChangelogBook a demoSign up

Jira

Keep your team's projects and tickets up-to-date with fresh customer data

Supported syncing

Sync TypeDescriptionSupported Sync ModesAPI documentation
IssuesSync data from any source to Jira issues or Product Discovery ideasUpsert, Update, InsertIssues

For more information about sync modes, refer to the sync modes docs.

Connect to Jira

Go to the Destinations overview page and click the Add destination button. Select Jira and click Continue. You can then authenticate Hightouch to Jira by entering your Jira Domain, Username, and API Token from your Jira account:

  • the Jira Domain is the text before .atlassian.net in the URL,
  • Username is the email you use to login to Jira,
  • and if you don't already have an API Token, you can create one in your Jira account by navigating to Account Settings > Security > Create and manage API tokens.

Sync configuration

Once you've set up your Jira destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Jira destination you want to sync to.

Syncing issues and ideas

Hightouch supports syncing to Jira issues and Product Discovery ideas. If you want to sync to Product Discovery ideas, select a Product Discovery Project in your sync configuration and use Insert mode.

Record matching

Upsert and Update mode are only supported for Jira issues. They require you to create a custom field in Jira to use for record matching in Hightouch. This field needs to be set to the Text Field (read only) type.

To create a custom field in Jira:

  • Navigate to Settings > Issues > Custom Fields.

  • Click Create custom field and select the Text Field (read only) field type.

Ensure all issue fields and custom fields that you want to sync to are included on your project's screen. To add custom fields to the screen, navigate to the custom field, click the three-dot menu and then Associate to Screens.

Field mapping

You can map model columns to all Jira issue fields that are available to the Project and Issue Type you selected in your sync configuration. To sync successfully, ensure the Description field is in Atlassian Document Format and that these other fields are of these types:

  • parent > id
  • priority > name (for example, Highest, High, Medium, Low, or Lowest)
  • creator > accountId
  • assignee > accountId
  • reporter > accountId

Hightouch doesn't currently support syncing to Status fields, so this needs to be done manually in the Jira dashboard. Please if you're interested in this feature.

Tips and troubleshooting

Common errors

To date, our customers haven't experienced any errors while using this destination. If you run into any issues, please don't hesitate to . We're here to help.

Live debugger

Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.

Sync alerts

Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.

Ready to get started?

Jump right in or a book a demo. Your first destination is always free.

Book a demoSign upBook a demo

Need help?

Our team is relentlessly focused on your success. Don't hesitate to reach out!

Feature requests?

We'd love to hear your suggestions for integrations and other features.

Last updated: Nov 17, 2023

On this page

Supported syncingConnect to JiraSync configurationSyncing issues and ideasTips and troubleshootingCommon errorsLive debuggerSync alerts

Was this page helpful?