Keep your team's projects and tickets up-to-date with fresh customer data
Setup
After selecting Jira from our destinations catalog, you will be required to enter your Jira Domain,
Username, and API Token from your Jira account. Your Jira Domain is the text before .atlassian.net in
the URL, Username is the email you use to login to Jira, and if you do not already
know your API Token, you can create one in your Jira account by navigating to
Account Settings > Security > Create and manage API tokens.
Syncing
Hightouch supports syncing to the following Jira objects:
Issues
Issue objects in Jira will use a custom field to map the Jira issue to your row source unique ID. To create a custom field:
-
Navigate to Settings > Issues > Custom Fields.
-
Create custom field and create a Text Field (read only) field type.
Ensure all issue fields and custom fields that require syncing are
included in your project's screen. You can add custom field to the desired
screen by navigating to the custom field {">"} Associate to Screens
Sync modes
Hightouch supports the following sync modes:
- Upsert - pushes new objects to Jira and updates fields that change in your warehouse.
- Update - updates fields on existing objects in Jira that change in your warehouse.
You can choose the Project and Issue Type you would like to sync to.
Record matching
Records can be matched from your source to the Jira workspace by using the Text Field (read only)
custom field.
Field mapping
You can sync columns from your source to Jira's issue fields available to your selected Project and Issue Type. To sync successfully, ensure the Description field is in Atlassian Document Format and that source data representing the following 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 offer syncs for Status fields, this will have to be done manually in the Jira dashboard.
