Connecting Your Linear Workspace to Huddle

When you connect Linear to Huddle, you're authorizing access to a single workspace during the connection process. If you belong to multiple Linear workspaces, you'll need to connect each one separately.

How Linear Authorization Works

Linear uses a workspace-level OAuth authorization model. When you click "Connect Linear" and sign in through Linear's authorization screen, you'll be prompted to select which workspace you want to connect to Huddle.

This means:

• Each workspace requires its own connection. If you work across multiple Linear workspaces for different clients or teams, you'll authorize each one individually.
• You choose the workspace during authorization. Linear's OAuth flow presents a workspace selection screen where you pick which workspace to connect.
• New workspaces require new connections. If you join a new Linear workspace later, you'll need to return to Huddle and add that connection separately.

How This Differs From Other Platforms

Some platforms like Asana use user-level authorization, where a single OAuth connection grants access to all workspaces tied to your account. With Asana, you connect once and every workspace you belong to becomes accessible automatically.

Linear takes a more granular approach, giving you explicit control over which workspaces you share with Huddle. This can be useful if you want to keep certain workspaces private or only pull tasks from specific clients.

What Huddle Can Access

After authorization, Huddle can retrieve your issues, projects, and team information from the specific Linear workspace you connected. We only pull the data needed to display your tasks in your Huddle dashboard.

Connecting Multiple Workspaces

To connect additional Linear workspaces:

1. Go to your Huddle integrations settings
2. Click "Add Linear Workspace"
3. Sign in to Linear and select the workspace you want to add
4. Repeat for each workspace you want to include

Managing Your Connections