Appearance
Linear
Connect Linear to Flowstate for automatic effort tracking, cost attribution, and R&D reporting based on your team's work in Linear.
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 | Employee mappings | 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 → Data Integrations → Linear
- 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 → Data Integrations → Employee Mappings if emails don't match.
Sync schedule
Set the daily catch-up sync time under Settings → Data Integrations → Linear → Sync Schedule.
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