Source: https://manu-tests-all-orgs.docs-staging.pageloop.ai/integrations/project-management/linear

# 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](https://linearstatus.com). |

---