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.
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.
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.
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.
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.
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.
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.