Jira Notion integration

The Jira-Notion integration provided by Getint allows users to seamlessly sync their project data between the two platforms.

After setting up the integration, users will be able to view and manage their Jira tickets, tasks, bugs, and epics directly within Notion. This provides a unified workspace to track projects and collaborate with teams.

As this is a Fresh integration option, currently only the syncing of title and description fields between Jira and Notion items is supported. Additional fields like assignees, statuses, labels, and custom fields may be mapped in the future as we continue to enhance its integration capabilities.

This is a new integration, meaning full feature parity between the two platforms may not be available yet. However, we are committed to ongoing development and welcome feedback from users to help prioritize and expand integration capabilities over time. If certain functionalities are missing or if you encounter challenges during setup, reach out to us.

The guide below is your key to achieving seamless 2-way or 1-way integration between Jira and Notion. Given the unique characteristics of each tool, a thoughtful approach is essential for a successful setup. With Getint, ease and efficiency are at your fingertips. Our streamlined 3-minute setup process empowers you to establish a functional MVP integration in minutes. Getint’s dedicated team is on standby to facilitate your journey, offering personalized onboarding calls, expert support through our portal, custom script assistance for complex scenarios, and bespoke development solutions as needed.

0. Access the Getint App in Jira:

  • Navigate to Jira, go to "Apps," and select "the Getint app."

  • Select “Create Integration” then “Continuous Sync” or "Migration" based on your requirements.

1. Token Generation for Jira Cloud:

  • Visit Atlassian Account Settings.

  • Go to Security

  • Navigate to the API Token section and generate a token. This token serves as the password for Jira Cloud.

2. Establish a Connection with Jira:

  • Ensure you're logged in as a user with the correct permissions

  • Click "Select App" and choose Jira.

  • Select "Create New" to establish a new connection with your Jira instance.

  • Name your connection, and add the URL of your Jira instance (without "/" at the end).

  • Provide the login credentials.

3. Choose the Jira Project:

  • With a successful connection, a dropdown menu will appear.

  • Select the Jira project you want to integrate.

4. Connect to Notion:

  • In the Notion app, click on the three dots in the top right corner.

  • Select "Add a Connection," then navigate to "Manage Connections" and choose "Develop or Manage integrations."

  • Select “New Integration”

  • Provide a name for your integration, grant necessary permissions, and copy the API token.

  • Close the window, return to the Notion dashboard, and click on the three dots again.

  • Scroll down to add a connection and select the name of the connection that you have already created.

It might be necessary to refresh your browser to see the new connection in the list.

5. Configure Getint for Notion:

  • In the Getint app, choose "Notion" as the connection app.

  • Select "Create a new connection," name it, and provide the API Token.

  • Select the connection you want to integrate.

  • Choose the Notion database to synchronize.

6. Map Types:

  • Link Jira types (Task, Bug, Epic, Story) to synchronize in Notion.

  • Specify the fields for integration or synchronization.

Please note that the current version of Getint for Notion only supports the "Title" and "Description" fields. For syncing other fields like assignees, statuses, labels, or custom fields, please contact us directly at support@getint.io

7. Field Mapping:

  • Map key fields such as title/summary and description

  • After configuring, name and save your integration settings.

8. Filtering:

It is possible to filter the synchronization to have them customized for your needs and requirements.

UI Filtering Option:

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

  • Select if the filtering will apply to All items, New items, 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 once you created the filters and Save the integration.

JQL Filtering:

  • Select the app that will receive the filter.

  • Under the field Custom JQL, it is possible to provide a JQL, which will be the filter for your sync and appended to the one generated when searching for issues in Jira (e.g., status in ('In Progress')).

  • Save the integration.

9. Duplicate Setup and Select Different Projects:

  • Go to Workflows.

  • Click on the 3 dots on the right side and select "duplicate."

  • A side panel will appear. Select a new name for the integration (by default, the integration will be called “copy of” if the same projects are established).

  • On the dropdown menu, select the projects that you would like to integrate.

  • For each side, select Connect. Then Duplicate.

  • Save the new integration.

Last updated