Table of contents
Linear Setup
WorkSights connects to Linear through OAuth authorization at the workspace level. Setup takes a few minutes and requires workspace admin access in Linear to authorize the WorkSights app. Only Owners, Executives and Admins can connect services.
For an overview of how Linear activity appears in WorkSights, see Linear Overview.
Connecting Linear
Step 1: Connect in WorkSights
- Go to Services in the top navigation
- Find Linear in the list and click Connect
Step 2: Authorize WorkSights in Linear
Linear opens the workspace authorization page. Review the requested permissions and click Authorize to grant WorkSights access to your Linear workspace.
WorkSights installs at the workspace level. The webhook subscription is created at this point. No additional configuration is required in Linear.
Step 3: Review User Mapping
Complete this step before your team starts working in Linear. Linear webhook events identify users by ID rather than email. WorkSights matches those IDs to WorkSights users by email address at connection time. If events arrive before user mapping is complete, those activities may not be attributed to the correct user.
Open the Users tab to review mappings. For any user that did not map automatically, select the correct WorkSights user from the dropdown to complete the mapping.
Only mapped users have their Linear activity displayed in WorkSights.
What Happens Next
Once connected and users are mapped, WorkSights begins receiving Linear activity as your team creates and updates issues, leaves comments, and makes project changes. Activity appears on the timeline within about 20 minutes.
If your organization has more than one Linear workspace, connect each one separately from the Services page. Each workspace requires its own OAuth authorization.
You can review and update user mappings and connection settings at any time from the integration page.