TestApp.io integrates directly with Linear to keep your tasks, issues, and workflows in sync across both platforms. With real-time bidirectional sync powered by webhooks, changes made in either tool are automatically reflected in the other — so your team always stays aligned.

This guide walks you through connecting Linear, configuring field mappings, importing issues, migrating tasks, and monitoring sync activity.

1. Connecting Linear to TestApp.io

To get started, you need to authorize TestApp.io to access your Linear workspace via OAuth:

  1. In TestApp.io, navigate to Team Settings → Integrations → Linear.
  2. Click the “Connect” button next to the Linear integration.
  3. You will be redirected to Linear’s OAuth authorization page.
  4. Review the permissions requested and click “Authorize”.
  5. Once authorized, you will be redirected back to TestApp.io. Your Linear workspace is now connected.
Tip: Only team admins can connect or disconnect integrations. Make sure you have the necessary permissions in both TestApp.io and Linear before proceeding.

2. Selecting Your Linear Team

After connecting, you need to choose which Linear team to sync with:

  1. On the Linear integration settings page, you will see a list of available Linear teams from your workspace.
  2. Select the team whose issues you want to sync with TestApp.io.
  3. Click “Save” to confirm your selection.

This determines which Linear team’s issues will be synced, imported, or migrated within TestApp.io.

3. Configuring Field Mappings

Field mapping lets you define how statuses and priorities translate between TestApp.io and Linear:

Status Mapping

Map each TestApp.io task status to its corresponding Linear status. For example:

  • Open (TestApp.io) → Todo (Linear)
  • In Progress (TestApp.io) → In Progress (Linear)
  • Resolved (TestApp.io) → Done (Linear)

Priority Mapping

Similarly, map priority levels between the two platforms to ensure issues maintain the correct urgency when synced.

To configure mappings:

  1. Go to the Field Mapping section in your Linear integration settings.
  2. For each TestApp.io status, select the corresponding Linear status from the dropdown.
  3. Repeat the process for priority fields.
  4. Click “Save Mappings” when finished.

You can update these mappings at any time without disconnecting the integration. See Integration Power Features for more on field mapping management.

4. How 2-Way Sync Works

Once connected and configured, TestApp.io and Linear stay in sync in real time through webhooks:

  • Outbound sync: When you create, update, or complete a task in TestApp.io, the corresponding Linear issue is automatically updated.
  • Inbound sync: When a team member changes an issue in Linear (status, priority, assignee, comments), the linked TestApp.io task is updated accordingly.

Sync happens automatically — there is nothing additional to configure. Both platforms reflect changes within seconds of an update being made.

Note: Only tasks that are linked between the two systems will sync. Unlinked tasks remain independent.

5. Importing Existing Linear Issues

If your team already has issues in Linear that you want to bring into TestApp.io, use the import feature:

  1. In the Linear integration settings, click “Pull Tasks”.
  2. Browse the available issues from your selected Linear team.
  3. Select the issues you want to import.
  4. Click “Import Selected”.

Imported issues become TestApp.io tasks and are automatically linked to their Linear counterparts for ongoing 2-way sync.

6. Migrating Local Tasks to Linear

If you have tasks created locally in TestApp.io that you want to move to Linear:

  1. Go to your Linear integration settings and click “Migrate Tasks”.
  2. Select the local TestApp.io tasks you want to migrate.
  3. Map your TestApp.io statuses to the appropriate Linear statuses (e.g., “Open” → “Todo”).
  4. Confirm the migration.

Migrated tasks will be created as new issues in Linear and automatically linked for bidirectional sync going forward.

7. Viewing Sync History

TestApp.io maintains a complete audit trail of all sync events between your workspace and Linear:

  1. Navigate to Team Settings → Integrations → Linear → Sync History.
  2. You will see a log of every sync event, including:
    • Direction: Whether the sync was inbound (Linear → TestApp.io) or outbound (TestApp.io → Linear).
    • Status: Whether the sync succeeded or failed.
    • Timestamp: When the sync occurred.
    • Error details: If a sync failed, the reason is displayed.
  3. For failed syncs, click the “Retry” button to attempt the sync again.

Regularly reviewing sync history helps you catch and resolve any issues before they impact your workflow.

8. Troubleshooting

If you encounter issues with your Linear integration, try the following:

  • Sync not working: Verify the integration is enabled (not just connected). You can toggle it on/off in the integration settings without losing your configuration.
  • Authorization errors: Disconnect and reconnect the integration by going through the OAuth flow again.
  • Missing issues: Ensure you have selected the correct Linear team. Issues from other teams will not appear.
  • Failed syncs: Check the sync history for error details and use the retry button. Common causes include permission changes in Linear or network timeouts.
  • Field mapping issues: If synced tasks have incorrect statuses, review and update your field mappings.

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