Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.swoop.it/llms.txt

Use this file to discover all available pages before exploring further.

Swoop uses OAuth to securely connect to your app integrations. You authorize access once, and Swoop can then fetch content from that app integration whenever you need it.

​
Connect a new app integration

1

Open the app integrations panel

In the Swoop dashboard, open a chat and click the app integrations icon, or go to your account settings and select App integrations. (Or alternatively navigate to the app integrations panel directly)
2

Choose a service

Browse the list of available app integrations and click Connect on the one you want to add.
3

Authorize access

You are redirected to the service’s OAuth sign-in page (e.g., Google, GitHub, Notion). Sign in and grant Swoop the requested permissions.
4

Confirm the connection

After authorization, you are redirected back to the Swoop dashboard. The app integration now shows as Connected.
You can also connect an app integration mid-conversation. If Swoop needs access to an app integration you haven’t connected yet, it will prompt you with a connection request directly in the chat.

​
Manage existing connections

To view or remove your connected app integrations:
  1. Navigate to the app integrations panel in Swoop
  2. Find your connected app integration in the “Connected” section
  3. Click the three-dot menu (⋮) next to the app integration and select Disconnect
Disconnecting an app integration does not delete any presentations that were created using its content. It only prevents Swoop from fetching new content from that app integration.

​
Re-authentication

If a connection expires or is revoked on the provider side, Swoop will prompt you to reconnect. Click the connection request in chat or reconnect from the app integrations panel.
Composio does not automatically refresh expired tokens. If you see authentication errors for a previously connected app integration, disconnect and reconnect it.