Documentation

Start typing to search.

Account Selection During Connection Setup

Written by Ilya Sudakov

Updated on Oct 21, 2026

Overview

When creating a new connection for supported data sources, you can choose which accounts to sync instead of syncing all accounts by default. This gives you more control over what data is extracted and helps reduce unnecessary data processing.

If your data source supports account selection, you will see a two-step connection flow: Authorization followed by Account Selection.

Note

Note: Not all data sources support account selection. Some legacy sources may not have this feature enabled yet. If you need account selection for a specific data source, please contact your CSM - we'll enable it for you.

Setup guide

Step 1. Authorize your account

Provide your credentials (API key, OAuth, etc.) as usual. Once authorized, you will see a green checkmark next to Step 1 and will automatically move to Step 2.

Step 2. Choose your account sync mode

After authorization, you will see your available accounts and can choose how to sync them.

Option A — Sync all accounts (default)

  • Automatically syncs all current and future accounts added to this data source.
  • New accounts are included automatically — no manual action needed.
  • Best for most use cases.

Option B — Select specific accounts

  • Only syncs the accounts you explicitly choose.
  • New accounts added to the data source later will not be included automatically.
  • Use the search bar to find specific accounts.
  • Use Select all / Unselect all to manage selections quickly.
  • Toggle Show selected only to review your selection.

Note

Important: When using "Select specific accounts", any new accounts added to the data source in the future won't be synced automatically. You will need to manually add them via the Sync accounts button on the connection page.

Step 3. Create the connection

3.1. Choose your preferred account mode (all or selected).

3.2. If selecting specific accounts, check the accounts you want to sync.

3.3. Click Create Connection.

Note

Tip: You don't have to wait for accounts to load. If you click Create Connection while accounts are still loading, all accounts will be synced by default.

Managing accounts after connection is created

Once your connection is created, you can view and manage your accounts on the Accounts tab of the connection detail page.

Checking your Account Sync Mode

Go to the Settings tab of the connection detail page. Under Connection Details, you will see the Account Sync Mode field:

  • Selected accounts only — this connection syncs only the accounts you chose during setup.
  • All accounts — this connection syncs all current and future accounts automatically.

Connections with selected accounts

If you chose "Select specific accounts" during setup:

  • A yellow banner will appear on the Accounts tab: "This connection syncs selected accounts only. New accounts added to this data source won't be included automatically."
  • The account count badge shows how many accounts are synced (e.g., 2 accounts).
  • Use the Sync accounts button to re-fetch and update the account list.

Connections with all accounts

If you chose "Sync all accounts":

  • All current and future accounts are synced automatically.
  • No manual management needed.

Changing the Account Sync Mode

The account sync mode is set during connection creation and cannot be changed directly in the connection settings. To switch between "Sync all accounts" and "Select specific accounts", you need to re-authorize the connection:

1. Open the connection detail page and click Reconnect — in the ⋯ menu next to Extract, or in the authentication section of the Settings tab.

2. Click Re-authorize and sign in to the data source with the same account as before.

3. In the Account Selection step, your current sync mode and accounts are already selected. Choose a different sync mode or change the accounts.

4. Click Save account selection.

Note

Note: For OAuth connections, re-authorization updates the existing connection: its extraction orders and data stay as they are. For connections that use an API key or login and password, Reconnect on the connection page starts a new connection. See Reconnect a connection.

Was this article helpful?

Questions? The Improvado team is always happy to help. Send us an email, contact your Customer Success Manager, or raise a request in the Improvado Service Desk.