Connecting Your First Integration

Connecting Your First Integration

Integrations are what let Quickly do work rather than just describe it. This guide walks through connecting one, using Jira and Confluence as the examples.

Where Connections Live

Every connection is managed from Settings > Integrations, which has three tabs:

• Channels — messaging surfaces such as Slack, connected once per workspace by an Admin.
• Connectors — the OAuth integrations each person connects for themselves.
• Custom — integrations your workspace defines against its own APIs. Admin only.

For the tools in this guide, stay on Connectors.

Connecting Jira

1. Open Settings > Integrations > Connectors.
2. Find Jira and click Connect.
3. Sign in to Atlassian if you are not already.
4. Choose the Atlassian site to authorize, then review the access Quickly is requesting.
5. Click Accept.

The card now shows as connected. Quickly can create, read, update, assign, comment on, and search issues in any project your Atlassian account can reach.

Connecting Confluence

Confluence is a separate connection even though it shares an Atlassian account.

1. From the same Connectors tab, find Confluence and click Connect.
2. Complete the same Atlassian authorization flow.
3. Choose the site whose spaces you want Quickly to work in.

Once connected, Quickly can create pages, generate postmortems, fetch a page by ID, and search spaces by title.

Connections Are Per Person

Each team member authorizes their own accounts. This matters in three ways:

• Quickly acts with your permissions. If you cannot see a Jira project, Quickly cannot create issues in it on your behalf.
• Disconnecting your account has no effect on anyone else's connections.
• Tokens are encrypted individually and scoped to your account, never shared across the workspace.

What Admins Control

Admins can narrow an integration for the whole workspace rather than leaving every tool available. From an integration's settings, an Admin can enable a subset of its tools, apply per-integration autonomy rules, and block specific tools for members. See Managing Integrations.

If Something Goes Wrong

"Connection expired." OAuth tokens expire on a schedule set by the provider. Reopen Settings > Integrations > Connectors and click Reconnect.

"Insufficient permissions." Your account in the external tool lacks access to the project or space you asked about. Check your access in that tool directly, then retry.

The integration is not listed. Some integrations depend on your plan. Check Settings > Billing & Usage, or see the full catalog in Connecting Integrations.