Project Management
Linear
Linear
Linear: Overview and setup
Automate project and issue tracking with the Linear integration.
Connect Linear to Atomicwork to automate project creation, issue tracking, and team collaboration as part of your IT and engineering workflows.
Usecases
By connecting Linear, your teams can:
- Automate issue creation: Create Linear issues from Atomicwork workflows — for example, automatically generating an engineering issue when a bug report is submitted through the service catalog, complete with priority, assignee, and project assignment.
- Track and manage issues: List and retrieve issue details to keep teams in sync across tools without switching between platforms.
- Manage projects: Create and track Linear projects with start dates, target dates, and team assignments.
- Collaborate with comments: Add comments to issues directly from workflows — for example, posting a status update on a linked issue when an Atomicwork request is resolved.
Permissions
To connect Linear to Atomicwork, you need:
- Org admin access in Atomicwork
- Admin access to your Linear workspace
The integration authenticates via OAuth 2.0 and requests the following scopes during authorization:
| Permission | Purpose |
|---|---|
read | Read access to Linear resources — required for listing and retrieving projects and issues. |
write | Write access to Linear resources — required for creating and updating projects and issues. |
issues:create | Create new issues in Linear. |
comments:create | Add comments to existing issues. |
Setup
- Navigate to Settings > App Store > Linear.
- Click Connect to initiate the OAuth flow.
- Sign in with your Linear account and authorize the requested permissions.
- Once authorized, the integration is active.
Supported workflow actions
Once connected, you can automate the following Linear actions within your Atomicwork workflows:
| Action | Description |
|---|---|
| Create project | Create a Linear project with name, description, team, start date, target date, and lead. |
| Get projects | List Linear projects with optional filters. |
| Create issue | Create an issue with title, description, team, priority, assignee, project, state, due date, and estimate. |
| List issues | List Linear issues with optional filters. |
| Get issue | Retrieve detailed information about a specific issue by ID. |
| Add comment | Add a comment to an existing issue. |
| Call API | Make a generic GraphQL API call to Linear for custom operations. |
Troubleshoot common issues
| Error | Cause | Resolution |
|---|---|---|
| Authentication failure | The OAuth authorization code has expired or the redirect URI doesn't match. | Re-initiate the OAuth flow from Settings > App Store > Linear. |
| Token refresh failure | The refresh token has expired or been revoked. | Re-authenticate the integration to generate new tokens. |
| API errors (5xx) | The Linear API is experiencing issues. | Retry the operation. If the issue persists, check the Linear status page. |