Argorant Help
Help/Integrations

Connect Google Workspace mailboxes

Published by Argorant

A Workspace admin authorises Argorant once per domain, then every mailbox on the domain can send. No login per mailbox. About three minutes.

Argorant connects Google Workspace through domain-wide delegation: your Workspace admin authorises Argorant's client ID once for your domain, and from then on Argorant can send from, and read replies on, the mailboxes you choose. Nobody has to sign in per mailbox, no passwords are stored, and the admin can revoke the authorisation at any time.

Connecting a Google Workspace domain, start to finish

Before you start

  • You need a Google Workspace Super Admin for the domain. This is one change per domain, not per mailbox.
  • Personal @gmail.com addresses cannot be connected this way. Use a Workspace mailbox on your own domain.

Step 1: authorise Argorant in the Google Admin panel

  1. In Argorant, open Inboxes, click Add accounts, choose Connect existing, then Gmail / Google Workspace.
  2. Click the Domain-wide delegation link in step 1. It opens Security → Access and data control → API controls → Manage domain-wide delegation in your Google Admin panel.
  3. Click Add new.
  4. Copy the Client ID from Argorant (Copy button) and paste it into the Client ID field.
  5. Copy the OAuth scopes from Argorant (Copy button) and paste them into the scopes field. All three scopes must be there.
  6. Click Authorize.
Screenshot: Domain-wide delegation: Add new, Client ID and the three scopes filled in

Step 2: choose the mailboxes

  1. Back in Argorant, enter your domain and the admin's email address, then click Check. Argorant confirms the authorisation and lists every active mailbox on the domain.
  2. Tick the mailboxes that should send and click Connect. Each one is checked live and appears in Inboxes as Ready.
  3. Turn on warm-up before sending at volume.
Screenshot: The mailbox list after Check, with the senders ticked

What Argorant can and cannot do

  • Can: send campaign emails from the connected mailboxes and read replies to those emails, so they land in your Unibox.
  • Cannot: read mailboxes you did not connect, change settings, or delete anything.
  • Revoke: delete the entry under Domain-wide delegation. Every connected mailbox stops immediately.

Troubleshooting

  • "Google has no authorisation for this domain yet": the Client ID or a scope is missing or has a typo. Open the delegation entry and compare with the Copy buttons in Argorant. Google can take a minute to apply a new entry.
  • "This address is not a Workspace admin": the admin email must be a Super Admin on that exact domain.
  • Mailbox shows Not reachable after Connect: the user is suspended, has no Gmail licence, or is on a different domain alias. Fix in Google Admin, then run Health check in Inboxes.

Still stuck? support@argorant.com