Skip to main content
Issue trackers are in preview and are enabled per organization. Ask your Datafold contact or 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.