Installing Git-Zen for Linear

First, install Git-Zen from the Zendesk Marketplace and authorize Zendesk. Then continue here to connect Linear.

Authorize Linear

After you click Allow on the Zendesk authorization screen, Git-Zen opens the Linear authorization screen. If you are not signed in to Linear, Linear asks you to sign in. Linear always shows the consent screen, even if you authorized Git-Zen before.

Git-Zen requests these scopes:

Scope	Why Git-Zen needs it
`read`	Read teams, issues, labels, members, workflow states, cycles, projects, and templates
`write`	Update issue descriptions and labels when you link or edit an issue
`issues:create`	Create issues from Zendesk tickets
`comments:create`	Add comments to Linear issues from Zendesk
`admin`	Create the Git-Zen workspace webhook

Click Authorize.

During authorization, Git-Zen creates one workspace webhook named Git-Zen. It also turns on every team in your workspace on the Git-Zen Webhooks screen. You do not copy a webhook URL into Linear.

When the authorization window says Successful Authorization, close it.

Choose your Linear teams

Open any Zendesk ticket.
Click the Webhooks icon on the Git-Zen menu bar. Git-Zen lists the teams in your Linear workspace.
Clear the check box for each team that your agents should not use.
Click Save Changes.

Only the checked teams appear in the team list when an agent creates or links an issue. See Webhooks for what the check boxes do and do not control.

You are all set

You are ready to use Git-Zen.