How do I create a Linear issue from a ticket?
Connect Linear in Integrations with a personal API key, choose the team (and, optionally, the project) that receives the issues, then click Create Linear issue in the ticket detail. The issue is created in Linear and the ticket shows its link and status.
Before you start
- Connecting Linear: workspace role Owner, Admin, Editor or Collaborator. Finance, Guest and Agent roles do not see Integrations.
- Creating the issue: access to the Tickets page; see How to handle a ticket opened through the site chat?.
- A Linear account allowed to create issues in the chosen team.
- Each workspace can have one active Linear integration.
Connect Linear
- Generate the key in Linear: under Settings > Account > Security & access > Personal API keys, create a new key and copy it.
- In Clickmax, open Integrations > Explore integrations and select the Linear card.
- Paste the key into the Linear API key field and click Load teams.
- Under Team, select the team that receives the issues.
- Under Project (optional), select a project or leave No project.
- Finish the integration.
Issues created from tickets always land in the team and project chosen here.
Change the key, team or project
Open the Linear integration under your active integrations (pencil icon). The current key is never shown: fill in New API key (optional) only to replace it; the new one is validated when you save. To change the team, load the teams again and pick another.
Create the issue from the ticket
- Open Tickets and click the ticket.
- In the footer of the detail, click Create Linear issue. The button only appears with an active Linear integration.
- In the modal, check the Issue title and click Create issue.
Creation runs in the background. The ticket shows: