> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datafold.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Connect a Linear workspace so that Datafold can file and update issues as the Datafold app.

> [!NOTE]
>
> Issue trackers are in preview and are enabled per organization. Ask your Datafold contact or [support@datafold.com](mailto:support@datafold.com) to turn them on.

Datafold files issues and comments as the **Datafold** app in your Linear workspace, not as you. One Linear workspace connects to one Datafold organization.

## Install the app

**1. Open the Linear integration**

In Datafold, go to **Settings** → **Integrations** → **Issue Trackers**, click **Add new integration**, and choose **Linear**.

**2. Install in Linear**

Click **Install in Linear**. On Linear's consent screen, pick the workspace and approve the access that Datafold asks for. A Linear workspace admin must approve the install.

**3. Confirm the connection**

Linear sends you back to Datafold, and the status shows **Connected**.

Datafold asks for these Linear scopes: `read`, `write`, `issues:create`, `comments:create`, and `customer:read`.

## Restore access

If Linear refuses Datafold's access (for example, after an admin revokes the app), the page shows **Linear refused Datafold's access**. Click **Reinstall** and approve the access again.

**Disconnect** revokes Datafold's access to the workspace.

## Customer-hosted deployments

Each Datafold deployment needs its own registered Linear app before admins can install it. On deployments that Datafold operates, ask your Datafold contact to register it. If you host Datafold yourself, register a private Linear app for your deployment. A Linear app has one webhook URL, so each deployment needs its own app.

1. In Linear, create an OAuth application under **Settings** → **API** → **OAuth applications**.
2. Set the callback URL to `https://<your Datafold host>/integrations/linear/installed`.
3. Optional: enable webhooks with the URL `https://<your Datafold host>/integrations/linear/webhook`. Webhooks make Datafold see changes in Linear sooner. Without them, Datafold polls Linear.
4. A Datafold super admin opens **Global Settings** → **Linear App** and enters the app's client ID and client secret. If you enabled webhooks in step 3, also enter the webhook signing secret: without it, Datafold rejects every webhook delivery. The section shows the exact callback and webhook URLs to copy into Linear.

Until this is done, the Linear page shows **Linear is not configured on this deployment**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.