Skip to main content

Connecting Vanta & Linear

Overview

The Linear integration connects your Linear workspace to Vanta over OAuth, enabling access reviews, security issue tracking, and, optionally, issue creation and vendor procurement requests directly within your compliance workflows. It is best suited for teams that already use Linear as their primary issue tracker.

Estimated setup time: ~10 minutes


Use cases and capabilities

  • Access Reviews: Connect a Linear workspace and we automatically sync your members, teams, and team memberships to support personnel tracking and access review workflows, including catching Linear accounts that stay active after an employee is offboarded. Access reviews are always on.

  • Task Tracking: We import the Linear issues that have the labels you choose and show whether your security issues are resolved within your SLAs. Task tracking is always on.

⚠️ Note: We import issues only from the teams you select under Team access when you sign in to Linear. Any private team you select must include the account that connects Linear. Label matching isn't case-sensitive.

  • Task Creation: Create Linear issues from Vanta for remediation work, so fixes are tracked where your team already works. Task creation is on by default, and we ask Linear for write permissions only when it is on.

  • Evidence Collection via Attachments: Link a Linear issue to a Vanta document and we automatically surface the issue's attachments as recommended evidence, ready to be added without manual uploads. This works whether task creation is on or off.

⚠️ Note: We import files uploaded to the Linear issue, and images or files embedded in its description or comments. We don’t import links to files stored in other services, such as Figma. Files must be one of these types: DOCX, JPG, PDF, PNG, WEBP, XLSX, CSV, TXT, JSON, ZIP, BMP, SVG, MD, or AI, and no larger than 50 MB. We regularly check for new attachments.

  • Automated Comment Updates: When task creation is on, we post a comment on the linked Linear issue listing the attachments we synced, or the files that failed and why (for example, "Invalid file type"). If task creation is off, we can't post this comment, but your files still import.

  • Vendor Procurement: With Advanced Vendor Risk Management, we create a procurement request for each Linear issue that has the vendor labels you choose.

Capabilities overview

Resource / Capability

Supported

How it is used in Vanta

User Accounts

Yes

Personnel tracking, access reviews

Teams and Team Memberships

Yes

Limited to the teams you select under Team access

Issues

Yes

Security issue tracking, filtered by the labels you choose

Issue Status, Assignee, and Dates

Yes

Imported with each issue to show whether it is resolved within your SLAs

Labels

Yes (not case-sensitive)

Used to choose which issues we import

User Accounts

Yes

Create Linear issues for remediation work you start from Vanta

Teams and Team Memberships

Yes

We post automated comments on linked Linear issues, such as the result of an attachment sync

Issues

Yes

Evidence collection. Files uploaded to a linked issue, or embedded in its description or comments, are imported as recommended evidence. Links to other services are not imported

Issue Status, Assignee, and Dates

Yes

Create procurement requests from Linear issues that have your vendor labels

Labels

Yes (not case-sensitive)

Not supported, use Vanta's built-in offboarding workflows for access ticketing

Task Creation from Vanta

Yes (when task creation is on)

Not supported, manage incidents directly in Vanta

Comment Posting

Yes (when task creation is on)

Connect more than one Linear workspace to Vanta, but connect each workspace only once. A second connection to the same workspace breaks the first


Prerequisites

Before starting setup, confirm the following:

  • You have permission to manage integrations in Vanta.

  • You have the Admin role in the Linear workspace you want to connect. Linear installs Vanta at the workspace level, so only an Admin can approve it.

  • To track a private team's issues, you belong to that team.

💡 Tip: During setup, you choose which Linear teams we can read under Team access. Know in advance which teams own the issues relevant to your compliance work. We import issues only from the teams you select.

⚠️ Note: You can connect more than one Linear workspace to Vanta, but connect each workspace only once. Linear keeps one active token per workspace for Vanta, so adding a second connection to a workspace that is already connected breaks the existing connection.


Explore the integrations page

When you navigate to the Linear integration, you'll land on its listing page, which includes five tabs that cover what you need to know before (and after) you connect.

  • Overview — Start here. A summary of what the integration does, its top capabilities, and the prerequisites you'll need in place before connecting. When you're ready, select Connect to begin setup.

  • API permissions — Exactly what access Vanta requests from Linear: each permission's scope, whether it's read or write, and what data it covers, etc. Share this tab with your security team if they need to review access before you connect.

  • Resource types — Every resource type Vanta imports from Linear, down to the specific fields collected for each. Use this to understand exactly what data will show up in Vanta once connected.

  • Automated tests — How many tests connecting Linear unlocks and which frameworks and controls they map to (SOC 2, ISO 27001, etc.), plus the full list of tests by name. Useful for scoping compliance coverage ahead of an audit.

  • Security — How Vanta protects the data it collects — encryption, data retention, access controls, and infrastructure. Visit Vanta's Trust Center for the full picture.

When you’re ready to connect, continue to the setup guide below.


Setup guide

Step 1: Find the Linear integration in Vanta

  • In Vanta, go to the Integrations page, click Add integration, and search for Linear. For help, see our guide to the Integrations Page.

  • Click on the Linear integration tile.

  • Click Connect.

Step 2: Select features

  • In the Select features step, choose what you want us to do with Linear. We request only the permissions the features you choose need.

  • Access reviews are always on, and Task tracking is on and locked.

  • Leave Task creation on to create Linear issues from Vanta and let us comment on linked issues. Turn it off if you want us to have read-only access.

⚠️ Note:If you turn task creation off, we can't create Linear issues or comment on linked issues. Attachments from linked issues still import as recommended evidence. To change this setting later, including going back to read-only access, you currently need to disconnect Linear and connect it again. See "I need to change my settings after connecting" in the troubleshooting section below.

Step 3: Set up vendor procurement (optional)

  • We show this step only if you have Advanced Vendor Risk Management. If you don't see it, skip to Step 4.

  • Choose whether to turn on Create procurement requests from Linear issues. When it's on, we create a procurement request for each Linear issue that has the vendor labels you choose in Step 5. It's off by default.

⚠️ Note: To change this setting later, you currently need to disconnect Linear and connect it again. Procurement requests we've already created are kept. See "I need to change my settings after connecting" in the troubleshooting section below.

Step 4: Authorize the connection

  • In the Sign in step, click Connect. We redirect you to Linear.

  • Log in with the Linear Admin account you want to use for this connection, then select the workspace to connect at the top left.

  • Under Team access, choose the teams we can read. Any private team you select must include you, or Linear shows a blank Unauthorized page. If that happens, return to Vanta and connect again, choosing only private teams you belong to.

  • Review the permissions we're requesting and click Authorize.

  • Linear redirects you back to Vanta automatically.

Step 5: Set sync filters

  • Under Security resolution, use Sync issues with these labels to select or type the Linear labels that mark the security issues your team tracks, for example security. We import issues that have any of these labels.

  • If you turned on vendor procurement in Step 3, a Vendor procurement section also appears. Select or type the labels that mark issues your team opens to review a vendor, for example securityreview.

  • Labels aren't case-sensitive, and you can type a label your workspace doesn't have yet. Each section you see needs at least one label.

  • Finish setup.

Step 6: Confirm the connection

  • After you finish, the Linear integration should appear as Connected in your Vanta integrations list.

  • We begin importing your Linear members, the teams you selected and their memberships, and the issues in those teams that have your labels.

ℹ️ Note: We name the connection after your Linear workspace, and you can rename it. To change which teams we read after connecting, go to Settings > Administration > Applications in Linear and select Vanta. Under App user, choose a different Team access option, then click Update.

💡 Tip: If no issues appear, check that the issues' teams are selected under Team access and that the issues have one of your labels.


Permissions

Read access

We use the authorization you grant during setup to read your workspace's members, the teams you share with us and their memberships, and the issues in those teams that have the labels you choose. This includes member names, email addresses, roles, status, and profile details; team names, settings, and memberships; and issue titles, descriptions, statuses, priorities, labels, assignees, and dates. We use this data to match Linear accounts to personnel records, run access reviews, and track security and vendor procurement issues.

Write access

We request write access only when task creation is on, and we use it in two specific situations:

  • Creating issues: When you create a Linear issue for remediation work you start from Vanta, we create it in your Linear workspace. We create it as the Vanta app, not as the account that connected Linear.

  • Posting comments: When we import a linked issue's attachments as evidence, we post a comment on that issue, again as the Vanta app.

We request only permission to create issues and comments. We do not request permission to edit or delete existing Linear issues or member data.


Troubleshooting and FAQs

The integration shows as disconnected or needs reconnection

  • Likely cause: Linear no longer accepts our connection. The authorization was revoked (for example, Vanta was removed under Settings > Administration > Applications in Linear), or the Linear account that connected the integration was disabled.

  • How to confirm: Go to Integrations in Vanta and check the status of the Linear connection. The message may read "Linear no longer accepts Vanta's connection to this workspace" or "Linear reports that the account used to connect Vanta is disabled."

  • Fix: Reconnect Linear as an active workspace Admin and complete the authorization again.

Linear shows a blank Unauthorized page during sign-in

  • Likely cause: You selected a private team under Team access that you don't belong to.

  • How to confirm: Check your membership in each private team you selected.

  • Fix: Return to Vanta, connect again, and choose only private teams you belong to.

Vanta says Linear didn't let us read your workspace

  • Likely cause: The account that connected Linear isn't a workspace Admin, or the teams selected under Team access don't include the data we need.

  • How to confirm: Look for the message "Linear didn't let Vanta read this workspace's members, teams, or issues. Reconnect Linear as a workspace Admin." during setup or in the integration's activity log.

  • Fix: Reconnect Linear as a workspace Admin. To change which teams we read, use Team access in Linear (see Step 6).

Linear issues are missing after sync

  • Likely cause: The issues' teams aren't selected under Team access, or the issues don't have one of your sync labels. If you chose All public teams, issues in private teams are left out even when you belong to those teams.

  • How to confirm: In Linear, open Settings > Administration > Applications, select Vanta, and check Team access under App user. Then confirm the issue has a label you entered in Set sync filters. Labels aren't case-sensitive.

  • Fix: Update Team access in Linear. To change your sync labels, you currently need to disconnect Linear and connect it again with the labels you want. See "I need to change my settings after connecting" below.

Vanta says an account is already connected

  • Likely cause: This Linear workspace is already connected to Vanta.

  • How to confirm: The message reads "Account ... is already connected by ... Connect a different account, or disconnect that one first."

  • Fix: If you meant to connect a different Linear workspace, connect that one instead. If the workspace is already connected and you want to change its settings, disconnect it first, then connect it again. Disconnecting removes the synced Linear users and issues. If the existing connection stopped working, see the next entry.

An existing Linear connection stopped working after I added another

  • Likely cause: Linear keeps one active token per workspace for Vanta, so connecting a workspace that is already connected replaces the first token and breaks the existing connection.

  • How to confirm: The original connection shows an error after the second connection attempt, even if Vanta rejected the new one.

  • Fix: Reconnect the existing connection. Connect each Linear workspace only once.

I need to change my settings after connecting

  • Likely cause: Editing an existing Linear connection isn't available yet, so you can't change your sync labels, the vendor procurement setting, or task creation (including going back to read-only access) in place.

  • How to confirm: The Linear connection has no option to edit these settings. You can change which teams we read in Linear without reconnecting (see Step 6).

  • Fix: Disconnect Linear, then connect it again and choose the settings you want. Disconnecting removes the synced Linear users and issues, and they sync again after you reconnect. Procurement requests we've already created and evidence you've already imported are kept.

Vanta says to update your sync filters

  • Likely cause: A required label field is empty.

  • How to confirm: The message reads "Update your sync filters. Security resolution: Add at least one label." (or Vendor procurement, if that section is shown).

  • Fix: Add at least one label to each section you see, then finish setup.

Vanta couldn't load my Linear labels or reports an unexpected Linear error

  • Likely cause: Linear didn't return the label list during setup, or Linear returned an error during a sync.

  • How to confirm: During setup, the message reads "Vanta couldn't load your Linear labels. Type the label names instead, or try again." During a sync, the activity log reads "Linear returned an error Vanta didn't expect."

  • Fix: During setup, type the label names or try again. During a sync, we try again automatically on the next sync. If it continues, contact Vanta support.