Setup

Prerequisites

• A monday.com account with admin permissions
• A Linear account with access to the teams and projects you want to sync

Getting Started

1. Install the App

Install Linear Integration from the monday.com marketplace. Only account administrators can install apps.

During installation, you will be asked to grant permissions. The app requires:

• boards:read — Read board structure, columns, and groups
• boards:write — Create and update items and columns on your boards
• me:read — Identify the current user

2. Add the Board View

After installation:

1. Open any board where you want Linear issues to appear
2. Click the + button next to your existing views
3. Select Apps and find Linear Integration
4. Click to add it as a new view on your board

Connecting Linear

3. Authorize monday.com

When you open the board view for the first time, you will be prompted to authorize the app. This grants Linear Integration permission to create items and columns on your boards.

4. Connect Your Linear Account

Click Connect Linear in the board view. A new tab opens to Linear's OAuth authorization page. Log in to Linear (if needed) and click Authorize.

The app requests read and write access to your Linear workspace, including admin access for managing webhooks (required for real-time sync). Once authorized, return to monday.com and click I've Completed Authorization.

Creating a Sync

After connecting, click New Sync to start the 4-step setup wizard.

Step 1: Select Source

Choose which Linear team and projects to sync:

• Team — Select a Linear team (e.g., Engineering, Platform)
• Projects — Select one or more projects from that team. Only issues assigned to the selected projects will be synced.

Step 2: Select Target

Choose which group on your monday.com board should receive the synced issues. Each sync maps to one group. You can create multiple syncs to different groups on the same board.

Step 3: Configure Fields

Select which Linear fields to sync. For each enabled field, Linear Integration will automatically create the appropriate column on your board (or reuse an existing column with the same name). Available fields:

• Status — Mapped to a Status column with Linear workflow states as labels
• Priority — Mapped to a Status column (Urgent, High, Medium, Low)
• Assignee — Mapped to a Text column with the assignee's name
• Issue URL — Mapped to a Link column pointing directly to the Linear issue
• Labels, Due Date, Estimate, Project, Cycle, Description, Identifier, Created At

Step 4: Review & Confirm

Review your sync configuration and optionally customize the display name. Toggle Sync existing issues to pull in all current issues from the selected projects, or leave it off to only sync new issues going forward.

Click Confirm to start. A progress bar shows the sync status. Once complete, your board is live with real-time updates.

Daily Usage

Once a sync is active, everything is automatic:

• New issues in Linear → new items appear on your board within seconds
• Updated issues (status, assignee, priority, etc.) → corresponding items update automatically
• Deleted issues in Linear → the corresponding monday.com item is moved to an “Archived (Linear)” group on your board (the item is preserved, not deleted)

Managing Syncs

The dashboard shows all syncs for the current board. Each sync card displays:

• Status label (Active, Paused, Board Not Found, Group Not Found)
• Number of synced issues
• Last update time

You can pause a sync to temporarily stop updates (the Linear webhook is removed), resume it to re-enable updates (a new webhook is created), or delete it entirely. Existing items on the board are never removed when you pause or delete a sync.

Note: Issues created or updated in Linear while a sync is paused will not be retroactively synced when you resume. Only new changes after resuming will be captured.

You can run multiple syncs on the same board — for example, one sync for the Engineering team and another for Platform, each targeting a different group.

Troubleshooting

• Sync shows “Board Not Found” or “Group Not Found” — The target board or group was deleted or archived. Restore it in monday.com, then click the refresh button on the sync card to re-check.
• Issues not appearing — Verify the issue belongs to one of the selected projects. Issues without a project assignment are not synced.
• Authorization expired — If your Linear token expires, the app will automatically refresh it. If refresh fails, you may need to reconnect Linear.

Need Help?

If you have questions or run into issues, email us at support@loomroad.com.