Search documentation...

ChangelogBook a demoSign up


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


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


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.

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: May 31, 2023

On this page

SetupSyncingSync modesRecord matchingField mapping

Was this page helpful?