IntakeRun
Sign in ↗Get started for free
FeaturesPricingAgencyFAQDownload
FAQ

Connect Google Workspace

faq · By · Oct 24, 2026

For a team mailbox on your company domain, a Google Workspace administrator authorises IntakeRun once for the domain. IntakeRun then reads and sends mail for the mailbox you choose over IMAP/SMTP with OAuth (XOAUTH2); no mailbox password is stored.

Before you start

  • You need a Google Workspace administrator for the domain.
  • The mailbox must have IMAP enabled.
  • Using a personal @gmail.com account instead? See Connect a personal Gmail account.

Connect the domain

  1. In IntakeRun, choose Add connection → Google Workspace. If IntakeRun shows a Client ID, use that (platform-managed). Otherwise create a service account in Google Cloud and download its JSON key.
  2. Open admin.google.com → Security → Access and data control → API controls → Domain-wide delegation.
  3. Click Add new, paste the Client ID, and authorise the scope https://mail.google.com/.
  4. Enable IMAP under Apps → Google Workspace → Gmail → End User Access → POP and IMAP access.
  5. In IntakeRun, paste the service-account JSON if asked, choose the mailbox, then click Connect and run the test.

Messages stay in Gmail. IntakeRun is the triage layer on top and replies from the connected mailbox.

Troubleshooting

  • Authorisation failed: confirm the Client ID and https://mail.google.com/ scope in domain-wide delegation.
  • IMAP unavailable: enable POP and IMAP for the Workspace account.
  • Mailbox not listed: confirm the mailbox is in the authorised domain and that the administrator has approved the service account.

Still stuck? Email support@taskfabric.com.

Tags: