Skip to main content

​
Overview

The Linear integration allows you to import your Linear workspaces and create bounties directly from Linear issues. Bounties are created as mirrored GitHub issues, enabling the full bounty workflow.

​
Prerequisites

  • A bounty.new account
  • A Linear workspace
  • A GitHub repository connected to bounty.new (for mirroring issues)

​
Installation

1

Navigate to integrations

Go to your organization’s integrations page at bounty.new/[slug]/integrations.
2

Install Linear

Click Install Linear and authorize bounty.new to access your Linear workspaces.
3

Sync workspaces

After installation, click Sync workspaces to import your Linear data.

​
Creating bounties from Linear issues

1

Navigate to your workspace

Go to the relevant Linear workspace in bounty.new.
2

Find the issue

Locate the Linear issue you want to turn into a bounty.
3

Create bounty

Click Create bounty on the issue.
4

Select base repository

Choose a GitHub repository where the mirrored issue will be created. This repository must be connected to bounty.new via the GitHub integration.
5

Set bounty price

Enter the bounty amount in USD.
6

Fund the bounty

The bounty is created as unfunded. You must fund it before accepting submissions.
Bounties created from Linear issues start as unfunded. Make sure to fund the bounty before promoting it, as you cannot pay submissions for unfunded bounties.

​
How it works

  1. Issue mirroring: When you create a bounty from a Linear issue, bounty.new creates a corresponding GitHub issue in your selected repository
  2. Bounty creation: The bounty is linked to the GitHub issue (since bounties function off GitHub issues)
  3. Submission workflow: Contributors submit PRs to the GitHub repository using the standard bounty workflow
  4. Payout: Once approved and merged, payouts are processed through Stripe

​
Managing Linear integration

​
Syncing workspaces

To refresh your Linear workspace data:
  1. Go to your organization’s integrations page at bounty.new/[slug]/integrations
  2. Find the Linear integration
  3. Click Sync workspaces

​
Disconnecting Linear

To remove the Linear integration:
  1. Go to your organization’s integrations page at bounty.new/[slug]/integrations
  2. Find the Linear integration
  3. Click Disconnect

​
Troubleshooting

Ensure you have at least one GitHub repository connected to bounty.new. The Linear integration requires a GitHub repository to mirror issues.
Click Sync workspaces in the Linear integration settings to refresh your workspace list.
Verify the bounty is funded. Bounties created from Linear issues start as unfunded and must be funded before accepting submissions.

​
Next steps

GitHub integration

Learn about the GitHub bounty workflow.

Payment settings

Configure payouts and billing.