You need to be signed into your Ferndesk workspace before connecting an integration. Make sure you are logged in and that you are in the correct organization. If you have access to multiple Ferndesk workspaces, switch to the one where you want to add the Linear connection.
Linear integration
Connect your Linear account to Ferndesk so Fern can read your completed issues and identify documentation gaps.
You need a Linear account to complete this integration. If you do not have one, create one on the Linear website.
Connect Linear
From your Ferndesk dashboard, click Integrations in the sidebar.
Find the Linear card and click Connect.
You will be redirected to Linear to authorize the connection. Log in to your Linear account if you are not already logged in, then grant Ferndesk permission to access your Linear workspace.
After authorizing, you will be redirected back to Ferndesk. The Linear integration will show as connected.
Once connected, Fern will automatically sync completed issues from Linear to your help center.
Troubleshooting
I see "Authentication required to connect Linear"
I see "Linear OAuth organization does not match the active session"
The Linear workspace you are authorizing belongs to a different organization than the one you are signed into in Ferndesk. Make sure you are:
Signed into the correct Ferndesk workspace
Authorizing the Linear workspace that corresponds to that Ferndesk organization
If you need to connect a different Linear workspace to a different Ferndesk organization, switch to that organization in Ferndesk first, then connect Linear.
The Linear authorization page shows an error
This can happen if:
Your session expired. Try signing out of Ferndesk and signing back in.
The OAuth state became invalid. Close the authorization window and click Connect again in Ferndesk.
Additional resources
For more information on Linear features, visit the Linear Documentation.
Was this helpful?