# Context pack: Reconnect a connector

Source: https://nordvec.com/docs/guides/troubleshooting/reconnect-integration
Pack: https://nordvec.com/docs/packs/troubleshooting/reconnect-integration

This pack bundles one Nordvec guide with the guides it builds on and the guides it links to, in reading order, so an assistant reading it meets no reference it cannot follow.

## Contents

1. [Reconnect a connector](https://nordvec.com/docs/guides/troubleshooting/reconnect-integration) (this guide)
2. [Grant missing permissions](https://nordvec.com/docs/guides/troubleshooting/insufficient-scopes) (linked from this guide)

---

# Reconnect a connector
Source: https://nordvec.com/docs/guides/troubleshooting/reconnect-integration

Fix "authentication has expired" and "access has been revoked" sync errors by reconnecting the affected connector.

When a sync reports **"Your authentication has expired"** or **"Your access has
been revoked"**, Nordvec can no longer act on your behalf at the provider. The
connection itself needs to be renewed; retrying the sync without reconnecting
will not help.

## Why this happens [#why-this-happens]

- The provider expired the long-lived credential Nordvec holds. Some providers
  do this on a fixed schedule, others after a period of inactivity.
- You changed your password at the provider, which commonly revokes all
  connected apps.
- You (or a workspace admin) revoked Nordvec's access from the provider's
  connected-apps or security settings.
- The provider rotated its security policy (for example after suspicious
  activity on your account) and invalidated existing grants.

## How to fix it [#how-to-fix-it]

1. Open **Connectors** in Nordvec.
2. Find the affected connector. It shows the error state reported by the
   last sync, and a **Reconnect** button on its card.
3. Choose **Reconnect** and sign in to the provider with the **same account**
   you originally connected. Approve every permission the provider lists;
   declining one leads to a
   [missing-permissions error](/docs/guides/troubleshooting/insufficient-scopes)
   instead.

Reconnect is also available from the connector's details at any time, not
only after an error.

Reconnecting keeps everything already synced. Do not use **Disconnect** to fix
an expired sign-in: disconnecting permanently deletes every document the
connector synced.

If you sign in with a different account than the one the connector was set
up with, Nordvec refuses the reconnect and changes nothing. To switch accounts,
disconnect the connector and connect the other account instead.

### Connectors that cannot be reconnected in place [#connectors-that-cannot-be-reconnected-in-place]

Guru, Notion, Zendesk, Freshdesk, Trello and e-conomic do not offer
**Reconnect**, because Nordvec cannot confirm that a new sign-in belongs to the
same account. For these, disconnect the connector and connect it again. Disconnecting deletes the
documents it synced, and the next sync imports them again from the start.

## What happens after reconnecting [#what-happens-after-reconnecting]

The new sign-in replaces the old one and the error clears. A sync starts
right away, and documents that failed while the connection was down are
retried; the items listed under **"Items that could not be imported"** clear
as they import successfully.

Connectors are connected per user: reconnecting renews *your* connection and
does not affect anyone else's. Only the person who connected a connector can
reconnect it, and that includes workspace admins: an admin cannot reconnect a
colleague's connector.


---

# Grant missing permissions
Source: https://nordvec.com/docs/guides/troubleshooting/insufficient-scopes

Fix "missing required permissions" sync errors by reconnecting the connector and approving every requested permission.

When a sync reports **"Your account is missing required permissions"**, the
connection to the provider works, but it was granted fewer permissions (OAuth
scopes) than the connector needs to read your content. This is a property of
the grant itself, so the only fix is to redo the connection with the full set
of permissions.

## Why this happens [#why-this-happens]

- A permission was declined during the original connection flow. Some
  providers let you untick individual permissions on the consent screen.
- The connector gained a capability that needs an additional permission, and
  your older grant predates it.
- A workspace admin restricted which permissions third-party apps may hold, or
  the provider requires admin approval for some of them.

## How to fix it [#how-to-fix-it]

1. Open **Connectors** in Nordvec.
2. Find the affected connector and choose **Reconnect** on its card.
3. Sign in with the same account you originally connected, and on the
   provider's consent screen approve **all** requested permissions. Each one
   maps to a concrete need, typically reading the documents, files, or
   messages the connector syncs; there are no optional extras in the list.

Reconnecting keeps the documents already synced. Guru, Notion, Zendesk,
Freshdesk, Trello and e-conomic cannot be reconnected in place; for those, disconnect and
connect again, which deletes the synced documents and imports them again from
the start.

If the consent screen says an administrator must approve the app, forward the
request to your workspace admin. Providers with admin-consent flows (for
example Google Workspace and Microsoft 365 organizations, or Slack workspaces
with app approval) block the grant until an admin allows it, and reconnecting
before that approval will produce the same error.

## What happens after reconnecting [#what-happens-after-reconnecting]

The new grant replaces the old one, the error clears, and a sync starts right
away. Items that previously failed with permission errors are retried.
