Connect an integration
Open Settings → Connectors
Click the gear icon in the bottom-left sidebar to open Settings, then select the Connectors tab. You’ll see a grid of all available integrations.
Find the app you want to connect
Browse the integration grid by category, or use the search box at the top to find a specific app by name.
Click the app
Click the app’s tile to open its connector detail panel. You’ll see a description of what the connector can do and which permissions it requests.
Authorize via the app's OAuth page
Your browser is redirected to the app’s official authorization page (e.g., Google’s consent screen, GitHub’s OAuth page). Review the requested permissions carefully, then click Allow or Authorize.
Using a connected app
Once connected, you can invoke any app in several ways: @ mentions in chat Type@ in any chat input. A dropdown appears showing your connected apps. Select the app to pull it into your current conversation context.
Multiple accounts
Some apps support connecting multiple accounts. For example, you might connect both a personal Google account and a work Google account. Each account appears as a separate connector entry in Settings → Connectors. When using @ mentions, you can specify which account to use.Not all apps support multiple account connections. Apps that do support it will show an “Add another account” option after the first connection is established.
Reconnecting an app
If a connector shows “Needs reauthorization” or an error state, the OAuth token has expired or been revoked on the app’s side. To fix it:- Go to Settings → Connectors
- Click the affected app
- Click Reconnect
- Complete the OAuth flow again
What happens after connecting
| What changes | Details |
|---|---|
| @ mentions | The app appears in the mention dropdown in any chat |
| Agent Mode | The agent can use the app as a tool for tasks you assign |
| Tasks | You can reference the app in task instructions |
| Skills | Skills scoped to this app become available |
| Custom Agents | You can assign this connector to custom agents you build |
Connector permissions at a glance
When you connect an app, ZeroTwo requests only the OAuth scopes needed for the features it supports. These scopes are displayed on the app’s authorization page before you approve. You can review exactly what ZeroTwo can and cannot do with each app.If you want to change the permissions granted to a connector (e.g., add write access to an app you previously connected read-only), you need to disconnect and reconnect. The new OAuth flow will request the updated scopes.

