Skip to navigation
Project Management

Linear

View as Markdown

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:

PermissionPurpose
readRead access to Linear resources — required for listing and retrieving projects and issues.
writeWrite access to Linear resources — required for creating and updating projects and issues.
issues:createCreate new issues in Linear.
comments:createAdd comments to existing issues.

Setup

  • Go to Settings > Enterprise integrations > 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:

ActionDescription
Create projectCreate a Linear project with name, description, team, start date, target date, and lead.
Get projectsList Linear projects with optional filters.
Create issueCreate an issue with title, description, team, priority, assignee, project, state, due date, and estimate.
List issuesList Linear issues with optional filters.
Get issueRetrieve detailed information about a specific issue by ID.
Add commentAdd a comment to an existing issue.
Call APIMake a generic GraphQL API call to Linear for custom operations.

Troubleshoot common issues

ErrorCauseResolution
Authentication failureThe OAuth authorization code has expired or the redirect URI doesn’t match.Re-initiate the OAuth flow from Settings > Enterprise integrations > App store > Linear.
Token refresh failureThe 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.