This guide will walk you through the process of integrating Factory with Linear, enabling seamless interaction between Factory and your Linear projects.

​
Prerequisites

  • Admin access to your Linear workspace
  • A Factory account with admin privileges

​
Integration Steps

1

Access Factory Integrations

Log in to your Factory account and navigate to the Integrations section in your Settings.
2

Initiate Linear Integration

Locate and select the Linear integration option.
3

Authorize Factory's Linear Application

You’ll be redirected to Linear. Review the requested permissions and click “Authorize” to allow Factory access to your Linear workspace.
4

Configure Team and Project Access

Select the teams and projects you want Factory to interact with. You can adjust these settings later if needed.
5

Set Up Permissions

Ensure that Factory has the necessary permissions to view and create issues, manage workflows, and access relevant project data.
6

Confirm Integration

After granting permissions, you’ll be redirected back to Factory. Verify that the integration status shows as “Connected”.
7

Create a New Session

Create a New Session directly from Linear with this ticket in context by clicking the ”🔗 Factory - Open in Factory” link
  • Note that clicking this link will always create a new session.

​
Verification

To ensure the integration is working correctly:
  1. Create a test issue in one of the authorized Linear projects.
  2. Use Factory to interact with this issue (e.g., comment on it or change its status).
  3. Verify that the changes are reflected in Linear.

​
Best Practices

  • Regularly review and audit the permissions granted to Factory.
  • Use Linear’s team-level settings to manage access efficiently.
  • Keep your Linear workspace’s security settings up-to-date.

​
Troubleshooting

If you encounter issues during integration:
  • Ensure you have the necessary admin rights on both Factory and Linear.
  • Check Linear’s audit logs for any permission-related issues.
  • Verify that the integration has access to the intended teams and projects.
For persistent problems, contact Factory support with specific error messages or screenshots.

Security and Compliance

Learn about Factory’s security measures and how we protect your data