Skip to content

How do I bulk add Google Workspace mailboxes?

Bulk adding connects many mailboxes at once. Mailbox owners don’t need to do anything. Instead, a Google Workspace super admin gives timetoreply access in the Google Admin console.

To add just one mailbox, see How do I add a single Gmail or Google Workspace mailbox?

Bulk adding lets timetoreply:

  • Read your Gmail metadata, such as who sent an email and when. Not the content of your emails, unless email body ingestion is turned on.
  • Read the users and groups in your Google Workspace account, so you can choose which mailboxes to add.
  • Read your Google Calendar events, such as Out of Office, but only if you add the optional Calendar scope below.

You need to be a super admin in Google Workspace to do this.

  1. Log in to the Google Admin console.

  2. Go to Security → Access and data control → API controls.

  3. Click Manage Domain Wide Delegation, then Add new.

  4. In Client ID, enter:

    106363700407289388807
  5. In OAuth scopes, enter:

    https://www.googleapis.com/auth/gmail.metadata, https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/admin.directory.group.readonly

    If email body ingestion is on, also add https://www.googleapis.com/auth/gmail.readonly. The bulk-link page in timetoreply shows the exact list for your account.

  6. Click Authorize.

Google says changes can take up to 24 hours, but they usually work much sooner.

  1. Click Entities in the bottom-left corner.

  2. Go to Mailboxes and click Add mailboxes as admin.

  3. On the Google Workspace card, click Bulk Link Mailboxes.

    The Google Workspace card with the Bulk Link Mailboxes button

  4. Scroll to the bottom and enter your Google Workspace admin email address. timetoreply uses it to get your list of mailboxes.

  5. Click Continue To Mailbox Selection and choose the mailboxes you want to add.

  6. Click Save Mailboxes.

You can also choose mailboxes that are already in timetoreply. They’ll switch to the Google Workspace connection, which is more stable.

To remove the admin account used for bulk adding:

  1. Click your name in the bottom-left corner and select Settings.
  2. Go to Advanced Settings → Google Credentials.
  3. Find the admin account under Credentials for and click the trash icon.

To stop timetoreply’s access to your Google Workspace completely, also go back to Manage Domain Wide Delegation in the Google Admin console, click the timetoreply Client ID and click Delete.