# Connect Linear to a Shipfox workspace (https://www.shipfox.io/docs/integrations/linear/setup)

Description: Authorize a Linear workspace, copy the integration connection slug, and use Linear events or tools.

Connect Linear to trigger workflows from workspace events or let agents read and
update Linear. See the [Linear overview](https://www.shipfox.io/docs/integrations/linear) for its
capabilities.

## Before you begin [#before-you-begin]

You need access to workspace integration settings. You also need permission to
authorize an OAuth app in the target Linear workspace.

## Authorize the Linear workspace [#authorize-the-linear-workspace]

### Start the integration connection

Open **Settings → Integrations** in the workspace. Select **Linear**, then
start the integration connection.

### Authorize the workspace

Select the target Linear workspace and authorize the Shipfox app. Grant the
requested access so Shipfox can receive Linear events and call Linear tools.

### Record the integration connection slug

Open the new integration connection's menu. Select **Use this integration**.
Copy the slug. Triggers use that value as `source`. Tool steps and agent
steps use it as `connection`.

## Verify the integration connection [#verify-the-integration-connection]

Open **Settings → Integrations** and check that the Linear integration connection
is active. Use the saved slug with a [Linear event](https://www.shipfox.io/docs/integrations/linear/events)
or a tool from the [Linear tool reference](https://www.shipfox.io/docs/integrations/linear/tools).