Linear
Connect your Linear workspace to sync tickets created in FutureBase to Linear issues automatically.
The Linear integration connects FutureBase Tickets to your Linear workspace. When you create or update a ticket in FutureBase, the changes sync to Linear as issues — keeping your engineering team's workflow in one place without manual duplication.
What syncs
| FutureBase | Linear |
|---|---|
| Ticket title | Issue title |
| Ticket description | Issue description (Markdown preserved) |
| Ticket type | Issue label (bug, feature, improvement, task) |
| Ticket priority | Issue priority (urgent → urgent, high → high, medium → medium, low → low) |
| Ticket status | Issue status (mapped per your configuration) |
| Ticket assignee | Issue assignee (matched by email) |
Changes made to a ticket in FutureBase are synced to Linear within seconds via webhook. Changes made in Linear are not synced back to FutureBase — the sync is one-directional.
Connecting your Linear workspace
Go to Settings → Integrations → Linear.
Click Connect Linear. You'll be redirected to Linear's OAuth authorization page.
Authorize FutureBase to access your Linear workspace.
After authorization, you'll be returned to the dashboard. The integration is now connected.
You need to be a Linear workspace admin to install the integration.
Configuring sync settings
After connecting, go to Settings → Integrations → Linear → Configuration to set up the mapping.
Team mapping
Select which Linear team newly synced issues should be created in:
- Choose a default Linear team from the dropdown.
- Optionally override this per ticket label or type.
Project mapping
Optionally assign synced issues to a specific Linear project:
| Option | Description |
|---|---|
| No project | Issues are created without a project assignment |
| Default project | All synced issues go to one project |
| Dynamic | Map FutureBase ticket labels to Linear projects |
Status mapping
Map FutureBase ticket statuses to Linear issue statuses. This depends on the workflow configured in your Linear team. A default mapping is pre-filled:
| FutureBase status | Linear status (default) |
|---|---|
backlog | Backlog |
todo | Todo |
in_progress | In Progress |
in_review | In Review |
done | Done |
Adjust these to match the actual statuses in your Linear workflow.
Syncing tickets
Automatic sync
By default, all tickets you create in FutureBase are synced to Linear. You can restrict this to specific tickets using labels:
Go to Settings → Integrations → Linear → Sync Rules.
Enable Sync only labeled tickets.
Enter the label(s) that should trigger a sync (e.g., linear, engineering).
Save. Only tickets with a matching label will be synced.
Manual sync
To sync an existing ticket to Linear:
Open the ticket in FutureBase.
Click the Linear icon in the ticket actions panel.
Click Sync to Linear.
The ticket will appear as a new issue in Linear. A link to the Linear issue is saved on the ticket for reference.
Webhook behavior
FutureBase uses a webhook to send updates to Linear. The webhook fires on these ticket events:
| Event | Action in Linear |
|---|---|
| Ticket created | Linear issue created |
| Ticket title updated | Linear issue title updated |
| Ticket description updated | Linear issue description updated |
| Ticket status changed | Linear issue status updated (per mapping) |
| Ticket priority changed | Linear issue priority updated |
| Ticket assigned | Linear issue assignee updated |
| Ticket deleted | Linear issue is not deleted (kept for audit) |
Deleting a ticket in FutureBase does not delete the corresponding Linear issue. This is intentional — issues in Linear may have comments or audit history that should be preserved.
Disconnecting
To remove the integration:
Go to Settings → Integrations → Linear.
Click Disconnect.
Disconnecting stops all future syncs. Existing Linear issues that were created by the integration are not deleted.