For AI agents: the complete documentation index is available at https://docs.clickmax.io/en/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/en/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/en/features/messaging/create-linear-issue-from-ticket.md.
  • English
  • 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

    1. Generate the key in Linear: under Settings > Account > Security & access > Personal API keys, create a new key and copy it.
    2. In Clickmax, open Integrations > Explore integrations and select the Linear card.
    3. Paste the key into the Linear API key field and click Load teams.
    4. Under Team, select the team that receives the issues.
    5. Under Project (optional), select a project or leave No project.
    6. 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

    1. Open Tickets and click the ticket.
    2. In the footer of the detail, click Create Linear issue. The button only appears with an active Linear integration.
    3. In the modal, check the Issue title and click Create issue.

    Creation runs in the background. The ticket shows:

    What you seeMeaning
    Creating…The issue is still being created in Linear.
    Issue code, as a linkThe issue was created. Click the code to open it in Linear.
    Badge next to the codeThe issue's current status in Linear (Status in Linear). It follows the issue as it moves along there.
    Error message and Try againCreation failed. Fix the cause and click Try again.

    If it did not work

    MessageWhat to do
    "Invalid Linear API key."Generate a new key in Linear and paste it into the integration again.
    "Could not load the Linear teams. Try again."Check the key and click Load teams again.
    "Select the Linear team."Choose a team before saving the integration.
    "The Linear API key was revoked or is invalid. Update the integration."Paste a new key into New API key (optional) and save.
    "The default team or project no longer exists in Linear. Update the integration."Open the integration and choose another team or project.
    "The Linear integration is disabled or was deleted."Enable or recreate the Linear integration, then click Try again.
    "Could not create the issue in Linear."Click Try again; if it persists, contact support.