JIRA Integration: Setup and 2-Way Sync

Omar Masad -

TestApp.io integrates with JIRA through Atlassian’s OAuth 2.0 to provide real-time, bidirectional sync between your TestApp.io tasks and JIRA issues. Whether your team lives in JIRA or TestApp.io, changes flow automatically between both platforms — keeping everyone on the same page.

This guide covers everything from initial connection to importing issues, migrating tasks, and monitoring sync activity.

1. Connecting JIRA to TestApp.io

The JIRA integration uses OAuth 2.0 via Atlassian for secure authorization:

  1. In TestApp.io, go to Team Settings → Integrations → JIRA.
  2. Click the “Connect” button.
  3. You will be redirected to Atlassian’s OAuth authorization page.
  4. Log in to your Atlassian account (if not already logged in) and review the permissions.
  5. Click “Accept” to authorize the connection.
  6. You will be redirected back to TestApp.io with JIRA now connected.
Tip: You need admin-level permissions in your TestApp.io team to connect integrations. Ensure you also have the appropriate access in your Atlassian workspace.

2. Selecting Your JIRA Project

After authorization, choose which JIRA project to sync with:

  1. On the JIRA integration settings page, you will see a list of available projects from your connected Atlassian workspace.
  2. Select the project you want to sync with TestApp.io.
  3. Click “Save” to confirm.

All sync, import, and migration operations will target this selected project.

3. Configuring Field Mappings

Field mappings define how task data translates between TestApp.io and JIRA. Proper mapping ensures that statuses and priorities remain accurate when synced.

Status Mapping

Map each TestApp.io task status to the corresponding JIRA status. For example:

  • Open (TestApp.io) → To Do (JIRA)
  • In Progress (TestApp.io) → In Progress (JIRA)
  • Resolved (TestApp.io) → Done (JIRA)

Priority Mapping

Map TestApp.io priority levels to JIRA priority levels to ensure issues retain the correct urgency across platforms.

To configure your mappings:

  1. Open the Field Mapping section in your JIRA integration settings.
  2. Use the dropdowns to match each TestApp.io status with the appropriate JIRA status.
  3. Do the same for priority levels.
  4. Click “Save Mappings”.

Mappings can be updated at any time. For more details, see Integration Power Features.

4. How 2-Way Sync Works

With JIRA connected and field mappings configured, TestApp.io and JIRA stay synchronized in real time via webhooks:

  • Outbound sync (TestApp.io → JIRA): When you create, update, or complete a task in TestApp.io, the linked JIRA issue is updated automatically.
  • Inbound sync (JIRA → TestApp.io): When someone modifies a JIRA issue — changing status, priority, assignee, or adding comments — the corresponding TestApp.io task reflects those changes.

Sync is continuous and automatic. There are no manual steps required once the integration is configured. Changes typically appear within seconds.

Note: Only linked tasks and issues are synced. Creating a new task in TestApp.io does not automatically create a JIRA issue unless it was imported or migrated.

5. Importing Existing JIRA Issues

Bring your existing JIRA issues into TestApp.io with the import feature:

  1. In the JIRA integration settings, click “Pull Tasks”.
  2. Browse issues from your selected JIRA project.
  3. Select the issues you want to import into TestApp.io.
  4. Click “Import Selected”.

Imported issues become TestApp.io tasks and are linked to their JIRA counterparts for ongoing bidirectional sync.

6. Migrating Local Tasks to JIRA

If you have tasks that were created locally in TestApp.io and want to push them to JIRA:

  1. Navigate to your JIRA integration settings and click “Migrate Tasks”.
  2. Select the TestApp.io tasks you want to migrate.
  3. Map your TestApp.io statuses to the corresponding JIRA statuses (e.g., “Open” → “To Do”).
  4. Review the mapping summary and click “Confirm Migration”.

Each migrated task will be created as a new JIRA issue and linked for real-time sync going forward.

7. Migration from the Old JIRA Integration

If your team previously used an older version of the JIRA integration, you can migrate to the new OAuth-based integration:

  1. Go to Team Settings → Integrations → JIRA.
  2. If a legacy integration is detected, you will see a migration prompt.
  3. Follow the on-screen instructions to re-authorize via Atlassian OAuth 2.0.
  4. Your existing configuration (field mappings, linked tasks) will be preserved during the migration.

After migration, you will benefit from improved reliability, better sync performance, and the full set of integration features.

8. Viewing Sync History

TestApp.io logs every sync event between your workspace and JIRA in a detailed audit trail:

  1. Go to Team Settings → Integrations → JIRA → Sync History.
  2. Each entry shows:
    • Direction: Inbound (JIRA → TestApp.io) or outbound (TestApp.io → JIRA).
    • Status: Success or failed.
    • Timestamp: When the event occurred.
    • Error details: For failed syncs, the specific error message is shown.
  3. Click “Retry” on any failed event to re-attempt the sync.

Monitoring sync history regularly helps you identify and resolve issues quickly.

9. Troubleshooting

If you run into problems with your JIRA integration, here are common issues and solutions:

  • Cannot connect: Ensure you have the required Atlassian permissions. Try clearing your browser cache and re-initiating the OAuth flow.
  • Sync not working: Check that the integration is enabled (toggled on) in the settings. A connected but disabled integration will not sync.
  • Authorization expired: Disconnect the integration and reconnect it through the OAuth flow to refresh your credentials.
  • Wrong statuses after sync: Review your field mappings. Incorrect mappings are the most common cause of status mismatches.
  • Failed sync events: Open the sync history, review the error details, and use the retry button. Common causes include permission changes in JIRA or temporary network issues.
  • Missing JIRA issues: Verify you have selected the correct JIRA project. Issues from other projects will not appear.

For advanced features like toggling integrations, bulk imports, and detailed sync management, see Integration Power Features: Disable, Pull, Migrate, Sync History.

To learn more about how tasks work in TestApp.io, visit our Task Management guide.

Need help? Contact us and we’ll get back to you shortly.