Skip to content
Help Center
Submit a request Sign in

Connect and manage Linear

Linear integration connects a workspace for supported issue and comment actions. The configuration screen focuses on connection identity, health and availability.

Applies to: Supportbench Core. Location: Settings → Integrations → Linear. Requires Administer all integrations.

Before you begin

  • You need Administer all integrations and authorization to connect the intended provider organization. Obtain credentials through your approved provider process; keep them out of screenshots and support messages.
  • Identify the intended engineering workspace and the enabled issue or comment surface your agents will use. This editor has no workspace-edit or field-mapping inputs and no full-resynchronization control.
  • Choose approved test records and people before sending messages, creating engineering work or making calls. Record the current connection identity and enabled options so the test has a clear expected result.

Configure and verify

  1. Open Settings → Integrations → Linear. When disconnected, choose Connect Linear and authorize the intended workspace.
  2. Choose Verify connection. Review Workspace, Verified as and Status before allowing operational use.
  3. Set Active as intended and choose Save Changes. Use the switch for a temporary pause while retaining the connection.
  4. Test an enabled issue-linking or update surface with a controlled Case and issue. This settings page has no editable workspace or field-mapping inputs.
  5. If Needs attention appears, investigate the conflicting or incomplete connection; Core does not automatically repair it. Use the verification evidence to decide the appropriate recovery.
  6. Choose Remove integration only when intentionally removing both the Linear webhook and local connection. Review the effect on linked workflows before confirmation.

Settings reference

Connection and operating controls

SettingWhat it controlsHow to choose
Connect LinearStarts authorization when disconnected.Choose the intended Linear workspace.
Verify connectionChecks an installed connection or one needing attention.Confirm workspace and verified-as identity.
Workspace / Verified as / StatusRead-only evidence of the connected workspace and user.Resolve an unexpected identity before using the connection.
ActivePauses integration actions while retaining the connection.Use this switch for a temporary pause rather than reconnecting unnecessarily.
Remove integrationDeletes the Linear webhook as well as Supportbench’s local connection.Review linked workflows before removal.

Behavior to know

  • Teams, projects, labels, priorities, linked issues and authenticated updates depend on the related application surfaces being enabled. There are no editable workspace or field-mapping controls on this page.

Recommended use

  • Verify Workspace and Verified as before using a support-to-engineering action. A valid connection to the wrong workspace is still an operational error.
  • Keep the support owner and next customer update explicit while engineering investigates. A linked issue is shared context, not a transfer of all customer communication responsibility.
  • Use Active for a temporary pause. Remove integration also deletes the Linear webhook, so reserve it for a deliberate disconnect after reviewing dependent work.

Worked example: hand an equipment defect to engineering without losing the customer owner

  1. Illustrative situation: Northstar Equipment reports a repeatable firmware fault. Support has a Case with a verified reproduction, affected version and next promised update. The team wants to associate that investigation with engineering work in its intended Linear workspace.
  2. In the integration settings, Connect Linear if necessary, then Verify connection and confirm Workspace, Verified as and Status. Save Active only for the approved workspace. No field-mapping or broad-sync setup is required by this settings page.
  3. Use the issue creation, linking or comment action actually available on the enabled Supportbench surface. First check whether the engineering issue already exists. Include a concise sanitized reproduction and the information engineering needs; do not copy private customer messages simply because the connection is available.
  4. Inspect the intended Linear issue and any submitted comment with an authorized engineering user. Confirm that the issue belongs to the correct workspace and that the support-side relationship can be found again. Verify the result before repeating an action after an uncertain response.
  5. If the issue action is absent, check Active, verified identity and whether that particular application surface is enabled. If Status says Needs attention, investigate the displayed problem; Core does not promise automatic connection repair.
  6. Keep a support owner and next-update time on the Case. Follow the team’s normal customer communication and resolution checks; creation of an engineering issue or comment alone is not proof that the customer Case changed or the fault was fixed.

Troubleshooting

ProblemWhat to check
Needs attention remains after verificationReview the conflicting/incomplete connection and verified identity. Do not assume automatic repair occurred.
The issue action is unavailableCheck Active, verified connection and whether the associated application surface is enabled.
I cannot find workspace or mapping inputsThey are not editable controls on this page. Verify the installed identity and use the supported issue surface.
Webhook updates stopped after removalRemoval deletes the Linear webhook as well as the local connection. Review reconnection deliberately rather than treating removal as a pause.
  • Integrations → Use the data synchronization log
  • Organization → Configure agent roles and division access

Was this article helpful?