# Jira Asana integration

Integrate Jira with Asana using Getint to enhance workflows with other teams, facilitate communication among teams, companies, and customers, or migrate to Jira while keeping your backlog.

Asana and Jira offer key project management advantages: Asana’s user-friendly interface and flexible tasks complement Jira’s robust issue-tracking and development tools. Getint’s integration synchronizes tasks and timelines in real time across Jira Cloud, Data Center, or On-Premise, streamlining communication, boosting productivity, fostering collaboration, and aligning teams.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2Fq98yyQx3i4wUGqbrLfQb%2FAsana%20integration%20app.png?alt=media&#x26;token=67c2e796-063a-4c18-9daf-bf1ce3d322dc" alt=""><figcaption><p><a href="https://marketplace.atlassian.com/apps/1223932/asana-integration-for-jira-2-way-work-sync-and-migration?hosting=cloud&#x26;tab=overview">Check out our Asana integration app on the Atlassian Marketplace</a><br></p></figcaption></figure>

***

### Asana-Jira Licensing Model <a href="#asana-jira-licensing-model" id="asana-jira-licensing-model"></a>

The Asana-Jira licensing model with Getint is designed to accommodate different integration needs. Here’s an overview:

#### Standard Licensing <a href="#standard-licensing" id="standard-licensing"></a>

* A Getint license is only required on Jira, allowing seamless data synchronization between Asana and Jira.

  This makes setup simpler and faster, without the need for additional configurations in Asana.

#### Flexible License <a href="#flexible-license" id="flexible-license"></a>

* For managed services companies or organizations looking to integrate four or more instances (regardless of whether they are the same or different tools), Getint offers a **Flexible License.** This custom license covers a specific number of connections (i.e., up to 10 instances) without restrictions on the tools involved. You can also swap the integrated tools while the license remains active, offering unparalleled flexibility.

For more details on licensing, visit our [**Pricing Page**](https://docs.getint.io/billing-and-services/licensing).

#### Requirements to Build Your Integration: <a href="#requirements-to-build-your-integration" id="requirements-to-build-your-integration"></a>

* The **Getint app** must be installed in Jira.
* Comments are attributed to the user who created the connection. Therefore, we recommend using dedicated Service Accounts for both instances.
* Jira instances must have a dedicated user and an associated API token with permissions to read, write, view, and modify the project.
* **Personal Access Tokens** are required for Jira and Asana authentication. You can find the steps to generate the access token for your connectors here: [Connection Guide](https://docs.getint.io/guides/quickstart/connection#asana).

  &#x20;

### Setting Up Your Asana-Jira Integration <a href="#setting-up-your-asana-jira-integration" id="setting-up-your-asana-jira-integration"></a>

#### 1. Access the Getint App in Jira <a href="#id-1.-access-the-getint-app-in-jira" id="id-1.-access-the-getint-app-in-jira"></a>

* Navigate to **Apps** and select **Jira - Asana Integration**.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2FSWEnEqLNNcHyt6Kes0Ys%2FJira%20Asana%20integration%20app.png?alt=media&#x26;token=43cf63ef-6638-4a8c-a94c-476578d6588e" alt=""><figcaption></figcaption></figure>

#### 2. Create Integration <a href="#id-2.-create-integration" id="id-2.-create-integration"></a>

* Click **Create integration** or **Migration**.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2F1aCSBIKxzhW5qKbmoUM7%2FSelecting%20Continuos%20Sync%20or%20Migration.png?alt=media&#x26;token=27004d63-4fcb-4f3e-a039-55ce34cbc0bf" alt=""><figcaption></figcaption></figure>

#### 3. Token Generation (Password for Jira Cloud) <a href="#id-3.-token-generation-password-for-jira-cloud" id="id-3.-token-generation-password-for-jira-cloud"></a>

* For Jira Cloud, generate a Jira token. This token will act as your password:
  * Go to **Atlassian Account Settings**.
  * Navigate to **Security** and go to **Generate and manage** **API tokens**, then select an API token or an API token with scopes.
  * After creation, use this token as the password for Jira integration. More information about access tokens for Jira [here](https://docs.getint.io/guides/quickstart/connection#jira).

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2FYV5I55ZGM9PWEt9S5BDW%2FCreate%20API%20token%20or%20Create%20API%20token%20with%20scopes.png?alt=media&#x26;token=78ef7095-c7da-48b9-b3f1-4feb4ab2daf5" alt=""><figcaption></figcaption></figure>

#### 4. Generate an Asana Personal Access Token <a href="#id-4.-generate-an-asana-personal-access-token" id="id-4.-generate-an-asana-personal-access-token"></a>

* Log in to your Asana account and follow the steps in the video below to create the Access Token.

{% embed url="<https://www.loom.com/share/639cea037a6244bebc40e2441bbdb46f>" %}

* Make sure to securely store your token, as it will only be visible once.

#### 5. Connect to Jira <a href="#id-5.-connect-to-jira" id="id-5.-connect-to-jira"></a>

* In Getint, enter your Jira instance URL, username, and the API token.
* Use the Personal Access Token for Jira Cloud.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2Fp43oGd4oa3AM4mcymQzN%2FConnection%20with%20Jira.png?alt=media&#x26;token=bba4a8ff-115f-47c4-b5e7-d5f19e91c44e" alt=""><figcaption></figcaption></figure>

* Select the Jira project(s) you wish to integrate with Asana.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2FppFJJmNFBFt5sIA1XLa7%2FSelecting%20the%20Jira%20projects.png?alt=media&#x26;token=3bf2f1ca-74d6-488e-a115-aae789b32aa5" alt=""><figcaption></figcaption></figure>

#### 6. Enter the Asana Token in Getint <a href="#id-6.-enter-the-asana-token-in-getint" id="id-6.-enter-the-asana-token-in-getint"></a>

Once you have generated a Personal Access Token in your Asana instance, you will now have the option to connect the tool with Getint.

* Paste the **Asana Personal Access Token** into the API token field.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2Fy486lXRVA5mbi2jV4oJ7%2FCreating%20a%20connection%20with%20Asana.png?alt=media&#x26;token=ae25b81e-bb79-4f20-8abe-1b7414023ce1" alt=""><figcaption></figcaption></figure>

* Select the project(s) you want to sync with Asana.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2FoN9TOt5ahnr3O4KTFKUP%2FSelect%20the%20projects%20for%20Asana%20integration.png?alt=media&#x26;token=ab0fa07f-9c02-4309-b6c1-e979743de251" alt=""><figcaption></figcaption></figure>

* Click **Connect** to establish the connection.

#### 7. Issue Type Mapping <a href="#id-7.-issue-type-mapping" id="id-7.-issue-type-mapping"></a>

* Map the Jira issue types you want to sync with Asana tasks, such as mapping an Asana Task to a Jira task or a Jira bug to an Asana task.
* Consider using the **Quick Build** beta feature for automated type and field mapping, which can streamline the setup process.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2FLiZ33slATq8Zn8wBgo1G%2FMapping%20Jira%20and%20Asana%20issue%20types.png?alt=media&#x26;token=cc79e0ac-8b53-4032-8ca1-54a2a350cfb4" alt=""><figcaption></figcaption></figure>

#### 8. Item Routing <a href="#id-8.-item-routing" id="id-8.-item-routing"></a>

If you selected multiple projects on either or both sides, you must define Item Routing. All relevant information about defining conditions is here: [Syncing Many Projects](https://docs.getint.io/getintio-platform/syncing-many-to-many-projects#defining-conditions-in-items-routing).

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2FekSFFUt5L79pR4QnmAMR%2FItem%20routing%20Jira%20Asana%20integration.png?alt=media&#x26;token=9fb0bf8a-ad7e-4726-92e1-33a6fa2e09cb" alt=""><figcaption></figcaption></figure>

#### 9. Field Mapping <a href="#id-9.-field-mapping" id="id-9.-field-mapping"></a>

Review or manually map fields within mapped types, including title, description, and assignees.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2Fl0UEEhDIqsFLcYE818O1%2FJira%20Asana%20mapping%20configuration.png?alt=media&#x26;token=8455db49-714a-43e5-b0a5-6f4b41c43a5d" alt=""><figcaption></figcaption></figure>

Add your desired fields, and define the sync direction (unidirectional or bi-directional) with the arrows.

#### 10. Assignee Mapping <a href="#id-10.-assignee-mapping" id="id-10.-assignee-mapping"></a>

Use the assignee mapping option to match Jira assignees to Asana assignees, enabling precise synchronization of task ownership. For more details, visit our doc: [Assignees (users) mapping](https://docs.getint.io/getintio-platform/workflows/assignees-users-mapping).

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2Ft3Cw6OYHdI8XfVZdK3jJ%2FMapping%20assignees%20Jira%20Asana.png?alt=media&#x26;token=127b1f73-8b51-4722-8b80-f6ab9f84bde2" alt=""><figcaption></figcaption></figure>

#### 11. Status Mapping <a href="#id-11.-status-mapping" id="id-11.-status-mapping"></a>

Map status fields to align between Jira and Asana. For example, **To do** in Jira could be mapped to **Opened** in Asana.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2F2J5ukoeCscdLWCjpo6If%2FJira%20Asana%20Status%20Mapping.png?alt=media&#x26;token=f38bc245-f532-40ce-aea6-75f46ac5ad5e" alt=""><figcaption></figcaption></figure>

#### 12. Comments & Attachments <a href="#id-12.-comments-and-attachments" id="id-12.-comments-and-attachments"></a>

When enabling comment synchronization, you can filter by criteria such as created date, author, or visibility (public/private).

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2F5pw52qcd2EEhVR7LqVJK%2Fcomments%20and%20attachments%20Jira%20Asana.png?alt=media&#x26;token=62cc6bdd-33c1-4d89-9315-2638f378c2bb" alt=""><figcaption></figcaption></figure>

* To synchronize attachments, scroll down and enable the option.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2FxsXwS2dZGE0u8uohGdfL%2FSyncing%20attachments%20Jira%20Asana%20integration.png?alt=media&#x26;token=7c094528-0e7f-434f-a9d7-46f7c19a4eb2" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Inline images** aren't supported for the **Description** field.
{% endhint %}

#### 13. Filtering: <a href="#id-13.-filtering" id="id-13.-filtering"></a>

It is possible to filter the synchronization to have it customized for your needs and requirements. Please see the doc [Items Filtering](https://docs.getint.io/getintio-platform/workflows/items-filtering) for more details.

**UI Filtering Option:**

* Click on the filtering icon near the app icon in your integration. This will apply to that side of the integration.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2Fic4KPMS5ucwWkksIfynQ%2Ffilters%20in%20Jira%20Asana%20integration.png?alt=media&#x26;token=3c534b50-62f5-40ec-b6c6-4816e5669ac0" alt=""><figcaption></figcaption></figure>

* Select if the filtering applies to All, New, and Synced items.
* Note that if the option **New items** is selected, the filtering will apply only to the new items, and the already synced items will continue to sync and update. If the option **Synced items** is selected, only the already synced items will be updated based on that filter.
* Choose the options and add the value for the filter. It is possible to filter more than one option for each field.
* Select **Apply** after creating the filters and **Save** the integration.

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2FF2x1owIoB0tRdmOD7jXG%2Ffiltering%20items%20jira%20Asana%20integration.png?alt=media&#x26;token=f484f232-67e1-4109-bb68-65a147164027" alt=""><figcaption></figcaption></figure>

#### 14. Test the Integration <a href="#id-14.-test-the-integration" id="id-14.-test-the-integration"></a>

* Create test issues or tasks in Jira or Asana and observe how they synchronize.
* Ensure that the data between the two platforms is correctly synced.
* Monitor the integration status and the logs in Getint to verify that everything functions as expected.

***

#### Conclusion <a href="#conclusion" id="conclusion"></a>

Following this guide lets you set up the Jira-Asana integration with Getint. This configuration supports data synchronization of issues, tasks, and workflows across development and project management tools, allowing teams to collaborate while connecting developers and project managers.

For further assistance, please contact us at the [Support Center](https://getint.io/help-center) or [Schedule a Demo](https://calendly.com/d/cpws-jb2-8xx/demo-call-all-team).

<figure><img src="https://4106311246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MR6Z9V8zLATPQPOGSDf%2Fuploads%2FquqlmoKO6zqGHsjk6DTL%2FGetint%20Yellow%20Banner.png?alt=media&#x26;token=de8e62c8-2dd6-4ee8-8d8d-c133b8b954b4" alt=""><figcaption><p><a href="https://calendly.com/d/cpws-jb2-8xx/demo-call-all-team">Having issues building your integration? Schedule a free consultation with our Integration Experts now!</a></p></figcaption></figure>
