> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerotwo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Connectors

> View, reconnect, update scopes, and disconnect your ZeroTwo integrations.

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:

| Field                 | What it means                                                           |
| --------------------- | ----------------------------------------------------------------------- |
| **App name & icon**   | The connected service                                                   |
| **Status**            | Connected, Needs reauthorization, or Error                              |
| **Account**           | Which account is connected (relevant when multiple accounts are linked) |
| **Last used**         | When ZeroTwo last made an API call to this app                          |
| **Authorized scopes** | The permissions you granted during the OAuth flow                       |

<Tip>
  Sort by "Last used" to identify apps you connected but haven't been using — good candidates for cleanup.
</Tip>

## Disconnecting an app

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

<Steps>
  <Step title="Go to Settings → Connectors">
    Open Settings via the gear icon in the sidebar, then select the Connectors tab.
  </Step>

  <Step title="Click the app you want to disconnect">
    Find the app in your connected apps list and click its tile or name.
  </Step>

  <Step title="Click Disconnect">
    Click the **Disconnect** button in the app's detail panel.
  </Step>

  <Step title="Confirm">
    Confirm the disconnection. ZeroTwo immediately deletes the stored access token and refresh token.
  </Step>
</Steps>

<Warning>
  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.
</Warning>

## 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:

<Steps>
  <Step title="Find the connector">
    In **Settings → Connectors**, look for connectors with the "Needs reauthorization" status badge.
  </Step>

  <Step title="Click Reconnect">
    Click the app tile, then click **Reconnect**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

<Info>
  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.
</Info>

## 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

<Tip>
  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.
</Tip>