Integrations
Linear Integration
Connect Linear for issue and project synchronization.
Linear Integration
Connect Linear to sync issues, track progress, and manage development workflows alongside your Workestra projects.
Screenshot needed � add an annotated image showing this UI
What It Does
- Issue sync — Sync Linear issues to Workestra tasks
- Status mapping — Align workflow states
- Bidirectional updates — Changes sync both ways
- Team alignment — Connect dev and business teams
Linear integration is currently in development. Basic connectivity is available with full sync coming soon.
Connecting Linear
OAuth Flow
- Go to Settings > Connected Accounts
- Click Connect Linear
- Sign in to Linear
- Grant permissions:
read— View issues and projectswrite— Create and update issues
- Select teams to sync
- Save
Scopes
| Scope | Purpose |
|---|---|
| Read | View issues, projects, teams |
| Write | Create issues, add comments |
| Admin | Webhook configuration |
Current Capabilities
What's Available Now
- OAuth authentication
- Team and project listing
- Basic issue viewing
- Manual import of issues
Coming Soon
- Real-time bidirectional sync
- Automatic issue creation
- Status workflow mapping
- Comment synchronization
- Time tracking integration
Manual Import
Importing Linear Issues
- Go to Projects > Import
- Select Linear
- Choose:
- Linear team
- Project
- Issue state
- Preview issues
- Select to import
- Map fields
- Import
Field Mapping
| Linear | Workestra |
|---|---|
| Issue Title | Task Title |
| Description | Description |
| State | Status |
| Assignee | Assignee |
| Labels | Labels |
| Due Date | Due Date |
| Priority | Priority |
Use Cases
Development Tracking
Connect engineering work:
- View dev progress in Workestra
- Link business tasks to technical issues
- Track cross-functional projects
Product Management
Align product and development:
- Feature requests in Workestra
- Linked to Linear epics
- Progress visible to stakeholders
Bug Tracking
Connect support and engineering:
- Support ticket escalates
- Creates Linear issue
- Status syncs back
- Customer updated
Configuration
Team Mapping
Map Linear teams to Workestra:
| Linear Team | Workestra Project |
|---|---|
| Engineering | Product Development |
| Design | Website Redesign |
| Mobile | Mobile App |
Status Mapping
Align workflow states:
| Linear | Workestra |
|---|---|
| Backlog | Backlog |
| Todo | Todo |
| In Progress | In Progress |
| In Review | In Review |
| Done | Done |
Troubleshooting
Connection Failed
- Check Linear account access
- Verify OAuth permissions
- Re-authenticate
Issues Not Syncing
- Integration is one-way manual for now
- Full sync coming in future update
- Use import feature currently
Webhook Errors
- Check webhook endpoint
- Verify Linear workspace settings
- Re-create connection
Next Steps
- Projects — Manage projects
- GitHub Integration — Code repository sync
- Linear Documentation