Skip to main content
All your connected apps are managed from Settings → Connectors. From there you can check connection status, disconnect apps you no longer use, and re-authorize tokens when they expire.

​
Viewing connected apps

Navigate to Settings → Connectors to see your full connector list. Each entry shows:
FieldWhat it means
App name & iconThe connected service
StatusConnected, Needs reauthorization, or Error
AccountWhich account is connected (relevant when multiple accounts are linked)
Last usedWhen ZeroTwo last made an API call to this app
Authorized scopesThe permissions you granted during the OAuth flow
Sort by “Last used” to identify apps you connected but haven’t been using — good candidates for cleanup.

​
Disconnecting an app

Disconnecting immediately and permanently removes ZeroTwo’s stored OAuth tokens for that app.
1

Go to Settings → Connectors

Open Settings via the gear icon in the sidebar, then select the Connectors tab.
2

Click the app you want to disconnect

Find the app in your connected apps list and click its tile or name.
3

Click Disconnect

Click the Disconnect button in the app’s detail panel.
4

Confirm

Confirm the disconnection. ZeroTwo immediately deletes the stored access token and refresh token.
Disconnecting is immediate. Any running agents, tasks, or skills that rely on this connector will lose access right away. Tasks scheduled to run in the future will fail until you reconnect.

​
Effect on tasks and agents

When you disconnect an app:
  • Agent Mode: the agent can no longer use that app as a tool
  • Tasks: any task that references the disconnected app will fail on its next run. ZeroTwo will notify you. Reconnect the app and the task will work on its next scheduled run without requiring any task edits.
  • Skills: skills scoped to that connector will be unavailable until reconnected
  • @ mentions: the app will no longer appear in the @ mention dropdown

​
Reconnecting / reauthorizing

If a connector shows “Needs reauthorization”, the OAuth token has expired or been revoked externally. To fix it:
1

Find the connector

In Settings → Connectors, look for connectors with the “Needs reauthorization” status badge.
2

Click Reconnect

Click the app tile, then click Reconnect.
3

Complete the OAuth flow

You’ll be redirected to the app’s authorization page again. Review permissions and authorize. You’re returned to ZeroTwo with a refreshed connection.
After reconnecting, the status returns to Connected and all agents, tasks, and skills that use this app resume normally.

​
Updating scopes

If you originally connected an app with limited permissions and now want to grant broader access (or restrict access), you need to reconnect:
  1. Disconnect the current connection (this deletes the old token)
  2. Reconnect the app — the OAuth flow will now show the updated scopes
  3. Authorize the new scope set
You cannot add new scopes to an existing connection without going through the OAuth flow again. This is a security feature of OAuth 2.0 — scope changes always require explicit re-authorization.

​
Managing multiple accounts

Some apps (e.g., Google) allow you to connect multiple accounts — for instance, both a personal Gmail and a work Gmail. Each account appears as a separate entry in the connectors list. To add an additional account for an app that supports it:
  1. Go to Settings → Connectors
  2. Click the app
  3. Click Add another account
  4. Complete the OAuth flow for the second account
To remove a specific account, click that account’s entry and click Disconnect.

​
Periodic connector review

It’s good practice to audit your connected apps periodically:
  • Disconnect unused apps — reduces your OAuth footprint and improves security posture
  • Check for “Needs reauth” connectors — stale connectors can cause unexpected task failures
  • Review scopes — ensure each app has only the permissions it actually needs
After finishing a project that relied on a specific integration (e.g., a Salesforce-connected task), disconnect the connector if you no longer need it.