Skip to main content
Every Knoq integration uses OAuth — you authorize the provider directly on their own login page, and Knoq receives a scoped access token in return. Your credentials never pass through Knoq, and you can revoke access at any time from either side. This guide walks you through connecting your first integration, checking its status, and disconnecting when you no longer need it.

​
Connect an integration

1

Open Settings → Integrations

Click your avatar or workspace name in the top-right corner of Knoq, then select Settings. In the left sidebar, choose Integrations. You’ll see the full connector gallery with all available integrations and a badge showing which ones are already connected.
2

Find the integration you want

Scroll the gallery or use the category chips at the top to filter by type — Knowledge, Communication, Project, Dev Tools, CRM, Design, Finance, or Automation. Each card shows the integration name, category, and a brief description of what Knoq can access.
3

Click Connect

Click the connector card to expand it, then press the Connect button. If you’ve reached your plan’s connector limit, Knoq will prompt you to upgrade before proceeding.
4

Authorize on the provider's page

Knoq redirects you to the provider’s official OAuth authorization page — for example, Slack’s login screen or GitHub’s authorization prompt. Review the requested permissions, then click Allow or Authorize to grant access. Knoq only requests the scopes it needs for search and retrieval.
5

Return to Knoq

After you authorize, the provider redirects you back to Knoq’s Settings → Integrations page. The connector card updates to show a green Connected badge, and you’ll see a confirmation message. If this is your first connector, Knoq will invite you to head straight to the chat and ask your first question.
After connecting, try a quick test query in the chat — for example, “Summarize recent activity in #general” for Slack, or “Show my open pull requests” for GitHub. A successful response confirms the integration is working.

​
Check connection status

The Settings → Integrations page shows the live connection status of every connector:
  • Green badge — Connected: The integration is active and Knoq can query it on your behalf.
  • No badge — Not connected: You haven’t connected this integration yet, or it was disconnected.
  • Red or error badge — Authorization error: The token has been revoked, expired, or the provider returned an error. You’ll need to reconnect.
If Knoq encounters an error while querying an integration mid-conversation, it surfaces a plain-language message rather than a raw error code. The Settings page will show the error badge on the affected connector.

​
Disconnect an integration

Disconnecting immediately revokes Knoq’s access to that tool. Knoq deletes the stored access token, and subsequent queries will no longer reach that integration.
1

Go to Settings → Integrations

Navigate to the connector gallery as described above.
2

Open the connected integration

Click the connector card that shows a green Connected badge.
3

Click Disconnect

Press the Disconnect button in the expanded card. Knoq asks you to confirm — click Disconnect again to proceed.
4

Confirm removal

The badge clears and the connector returns to its unconnected state. Knoq no longer holds an access token for that provider. Disconnecting does not delete any data from the provider itself.
Disconnecting is immediate. Any in-progress queries that involve that integration will fail once the token is removed. If you’re in the middle of a conversation that depends on the connector, finish it before disconnecting.

​
Reconnect after expiry

OAuth tokens issued by some providers expire after a set period, or a workspace admin may revoke them centrally. When this happens, the connector shows an error badge on the Settings page and Knoq will be unable to query that source. To reconnect, follow the same Connect an integration steps above. Knoq will walk you through the OAuth flow again, and a new access token will replace the expired one. You don’t need to reconfigure anything — your previous connector choice is preserved.
If a connector repeatedly shows an error badge after reconnecting, check whether a workspace admin at the provider (for example, a Slack workspace admin or GitHub organization owner) has restricted OAuth app access for your organization.

​
Connector limits

The number of integrations you can connect at one time depends on your Knoq plan: Free (2 connectors), Solo (5), Team (15), and Business (unlimited). Each connected integration counts as one connector. See concepts for full plan details and upgrade options.