From your workspace, open Settings and select Integrations.
The Integrations page shows available ticketing connections.
2
Add a ticketing integration
Jira
Linear
Prerequisites:
Jira Cloud or Jira Data Center access with permission to create issues
A Jira API token or personal access token
Select Add Jira to open the setup form. Enter the following details:
Display Name: A name to identify this integration
Base URL: Your Jira instance URL, such as https://yourcompany.atlassian.net or your Jira Data Center URL
Project Key: The key of the project where tickets will be created, such as KAN
Issue Type: The type of issue to create, such as Task or Bug
Email: The email address associated with your Jira account
API Token: A Jira API token for Jira Cloud or a personal access token for Jira Data Center. For help generating a token, see Atlassian’s documentation
Jira form filled with connection details.
Select Save Changes to connect the integration.
Prerequisites:
A Linear workspace with a personal API key that has the read and write scopes
Select Add Linear to open the setup form. Enter the following details:
Display Name: A name to identify this integration
Team Key: The short code for your Linear team, visible in issue identifiers (for example, SEC in SEC-123)
API Key: A Linear personal API key with the read and write scopes. To generate a key, go to Linear’s Security & Access settings
Linear form filled with connection details.
Select Verify Connection to connect to Linear and load your team’s workflow states.
Connection verified with workflow states loaded.
Choose a Default State for new tickets. Select a state like Todo or Backlog, or leave it as Use Linear default to use Linear’s default state.Select Save Changes to connect the integration.
3
Verify the connection
Jira
Linear
Return to Integrations to confirm Jira is connected.
Jira shows as connected in Cysmiq.
Return to Integrations to confirm Linear is connected.
