Zentrik + Linear

1. Open Settings → Integrations → Linear and choose Connect Linear.
2. Select the Linear organization and approve access.
3. Return to the integration page and confirm the organization name.
4. Open Cycles to choose the Zentrik team and Linear team before enabling webhooks.

OAuth tokens stay on the Zentrik backend and are refreshed automatically. An existing Linear API key can still run manual imports and cycle syncs, but webhook automation requires OAuth.

1. Open Initiatives and choose Create initiative.
2. Select Linear.
3. Search for and select the Linear initiative you want to bring into Zentrik.
4. Review the exact name, description, status, owner, and target date that Zentrik will use.
5. Review the suggested Zentrik product and features when Linear content clearly matches existing product structure. Change or clear any suggestion before continuing.
6. Choose Create & link initiative.

Zentrik creates one initiative. Parent initiatives, sub-initiatives, and direct projects remain in Linear. Suggestions are advisory: change or clear them before confirming. Confirmed Product and Feature assignments stay in Zentrik and are not synchronized with Linear afterward. If the initiative is already linked, Zentrik opens the existing initiative instead of creating a duplicate.

Watch the Linear initiative import walkthrough (MP4) · GIF version

This visual walkthrough uses a synthetic pre-production workspace. The product and feature assignments are advisory until the PM confirms them.

After creation, open Initiative connections from the Linear icon in the initiative header.

• Refresh Linear shows proposed changes before updating supported fields.
• Remote changes are reviewed before they replace Zentrik values.
• Unlinking removes the relationship; it does not delete the Linear initiative.

1. Open Discovery and choose Linear from the import source picker.
2. Select one or more projects to filter the issues you want.
3. Optionally add created since and updated since filters.
4. Review the exact count for the current filter set before importing.
5. Map Linear issue fields into Zentrik and choose whether records should become ideas or insights.
6. Start the import and let Discovery refresh automatically when the background job finishes.

Projects filter the issues you can import; they do not map to Zentrik products. You can also map issue state, priority, or labels into existing Discovery taxonomy groups. If a project or issue is missing, first check the authorizing Linear user’s visibility.

Workspace owners and admins can open Settings → Members → Sync with integrations and choose Linear. Zentrik proposes exact email matches first, then exact names only when the match is unambiguous. Suggestions are selected by default, and you can clear any row before saving.

This creates identity links for existing workspace members. It does not invite people or change users in Linear.

1. Open the connected Linear integration and find Cycles.
2. Choose the destination Zentrik team and source Linear team.
3. Turn on Use webhooks, then save.
4. Wait for the initial reconciliation to finish.

Linear becomes the source of truth for the selected cycle window and its linked issues. Change provider-owned dates, status, membership, and issue placement in Linear. Zentrik verifies signed deliveries, queues the refresh, and records the run on the integration.