Appearance
Linear
Connect Linear and effort tracking, cost attribution and R&D reporting come along for the ride as your team ships. Read-only — Flowstate never writes back to your workspace.
What syncs
| From Linear | Into Flowstate | Used for |
|---|---|---|
| Projects | PMS Projects | Linking to roadmap projects, effort attribution |
| Issues | PMS Tasks | Effort calculation, CapEx attribution |
| Issue status changes | Task activity | Effort tracking based on status movement |
| Assignees | User attribution | Attributing effort to the right people |
Flowstate reads from Linear — it never writes back or modifies your workspace.
How data stays in sync
Webhooks (real-time): Linear automatically sends notifications to Flowstate when issues are created, updated, or moved between states. Changes appear within seconds.
Scheduled sync (catch-up): A daily full sync ensures nothing is missed.
Getting started
1. Connect Linear
- Go to Settings → Integrations and open the Linear tile
- Enter your Linear API key
- Click Connect & Test
How to create a Linear API key
In Linear, go to Settings → API → Personal API keys and create a new key. Alternatively, create a workspace-level OAuth application for shared access.
2. Configure sync
Linear Projects map directly to Flowstate PMS projects. Issues within those projects are synced as tasks.
You can exclude specific projects you don't want to track.
3. Webhooks
Linear webhooks are configured automatically when you connect the integration. No manual setup required.
4. Map your people
Flowstate matches Linear users to employees by email address. Add manual mappings in Settings → Integrations → User attribution if emails don't match. To map external teams to Flowstate teams, use Settings → Integrations → Team attribution.
Sync schedule
Set the daily catch-up sync time under Sync Schedule on the Linear tile in Settings → Integrations.
Troubleshooting
Projects aren't appearing
- Verify the API key has access to the workspace
- Try a manual sync from integration settings
People aren't matched
- Check that Linear email addresses match Flowstate emails
- Add manual mappings in Settings → Integrations → User attribution
For sync run history and errors, check Settings → Integrations → Sync Health.