Sync Adapters

Sync adapters connect your UserHero workflows to external project management tools. When you push a workflow item to Linear or Jira, it creates a corresponding issue that stays linked — so your team can work in their preferred tool while you track everything in UserHero.

How Syncing Works

Workflow Item ←→ External Issue (Linear / Jira)
     ↑                    ↑
  UserHero            Your PM tool

• Push: Create an issue in Linear or Jira from a workflow item
• Pull: When the external issue is updated (status, assignee), the changes sync back to UserHero via webhooks

Each synced item stores an external reference linking it to the external issue (provider, project, issue ID, URL). You can click through to the external issue from the workflow item detail view.

Available Providers

Setting Up a Sync Adapter

1. Navigate to your project Settings → Sync Adapters
2. Click Add Adapter
3. Choose a provider (Linear or Jira)
4. Complete the OAuth authorization flow
5. Select the target team/project
6. Configure status mapping
7. Click Save

Once configured, you'll see a Push to [Provider] button on workflow items.

Status Mapping

Each provider uses different status names. Sync adapters map between UserHero workflow statuses and the provider's statuses:

Example (Linear):

You configure this mapping when setting up the adapter. See the provider-specific guides for default mappings.

Priority Mapping

Priorities are also mapped between systems:

Plan Requirements

Sync adapters are available on Growth and Pro plans.

Next Steps