You need to be signed into your Ferndesk workspace before connecting an integration. Make sure you're logged in and that you're 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 auto-update your help center using completed issues from Linear.
You'll need a Linear account to complete this integration. If you don't have one, create one on the Linear website.
Connect Linear
1
Go to Integrations
From your Ferndesk dashboard, click Integrations in the sidebar.
Make sure you're signed into the correct Ferndesk workspace. The integration will connect to the organization you're currently viewing.
2
Click Connect
Find Linear in the integrations list and click Connect.
3
Authorize in Linear
You'll be redirected to Linear to authorize the connection. Log in to your Linear account if you're not already logged in, then grant Ferndesk permission to access your Linear workspace.
4
Return to Ferndesk
After authorizing, you'll 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're authorizing belongs to a different organization than the one you're signed into in Ferndesk. Make sure you're:
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's features, visit their Documentation.
Was this helpful?