Jira Integration

Jira Integration

Jira is the integration most teams connect first. This page covers what Quickly can do with it, how to set it up, and where its limits are.

Connecting

1. Open Settings > Integrations > Connectors.
2. Find Jira and click Connect.
3. Sign in to Atlassian and choose the site to authorize.
4. Review the access requested and click Accept.

Each person connects their own Atlassian account. Quickly acts with your access, so it reaches exactly the projects you can reach and nothing else.

What Quickly Can Do

Creating

• Create an issue with project, type, summary, description, priority, and labels
• Create several issues in one request from a list or a discussion

Reading

• Fetch an issue by key
• Search with plain language, translated to JQL, or with JQL you write yourself
• List projects, list the issue types a project accepts, and look up users
• Read the work logged against an issue

Updating

• Change summary, description, and priority
• Transition an issue to a new status
• Assign or unassign, matching by name or email
• Add comments
• Add watchers, link issues to each other, and log work

Priorities

The default Jira scheme is Highest, High, Medium, Low, Lowest. Naming the priority as your instance defines it is the reliable route; "P1" style shorthand is mapped onto your scheme but depends on how that scheme is configured.

Issue Types

Types come from the target project's issue type scheme rather than a fixed list. If a request fails because a type does not exist, ask @Quickly what issue types are available in MOBILE? to see the real options.

Transitions

Status changes follow your project's workflow. A transition that the workflow does not allow from the current state is refused by Jira, and Quickly reports which transitions were available instead of guessing.

Supported Products

Jira Cloud, including Jira Software and Jira Work Management. Jira Server and Data Center are not supported, because the integration uses Atlassian's cloud OAuth.

Permissions Quickly Needs

Your Atlassian account must be able to read projects, read and write issues, and read users. If your account cannot do something in Jira directly, Quickly cannot do it for you, and the error it returns is the one Jira produced.

Working With Confluence

Jira and Confluence are separate connections even though they share an Atlassian account. Connect both if you want Quickly to reference an issue while writing a page, for example when generating a postmortem from an incident ticket. See Confluence Integration.

Troubleshooting

Failed calls are recorded in Action Logs with the error Jira returned. See Integration Errors for the common causes and their fixes.