Skip to main content
Connect a Gmail mailbox so Hiveku can send, read, or manage email for your CRM workflows, sales agents, and automations.
Before you start: set up your Gmail app, your organization’s internal Google app for Gmail. You do this once, and every Gmail inbox in your Google Workspace connects through it. Claude Code or Codex can do most of it for you.

​
Pick Your Scope

Gmail supports several access levels. Pick the smallest scope that does what you need:
To book meetings, also connect Google Calendar. Calendar and Meet connect in one click through Hiveku’s own Google app, separately from Gmail.

​
Connect the Mailbox

1

Open the connections page

In Hiveku, go to CRM > Connections, click Connect Workspace, and choose Gmail as the provider. For a support inbox, start from Helpdesk > Setup > Connections instead (see Help desk email).
2

Select your Gmail app

Under OAuth App (Google), pick the app you registered under Settings > OAuth Apps. If the list is empty, set up your Gmail app first.
3

Choose your scope

Pick one of:
  • Read Only: for reading the inbox
  • Send: for outbound email only
  • Full Access: for general CRM use and for help desk replies sent from this inbox, including labels and archiving
Choose carefully — changing scopes later requires disconnecting and reconnecting the mailbox, and the user must consent again.
4

Authorize with Google

Click Authorize with Google. You’ll be redirected to a Google consent screen showing your app name and the scopes you’re requesting.Sign in as the mailbox you are connecting (an account in your Google Workspace), review the access, and click Allow.
5

Confirm the connection

You return to Hiveku, where the new Gmail connection shows:
  • Your email address
  • Active scopes
  • Connection status (Active)

​
How new mail arrives

Hiveku checks each connected inbox for new mail every 10 minutes. In the CRM, mail from your contacts is logged on their timeline; in the help desk, new mail becomes a conversation. Sending is immediate.

​
Connect Multiple Mailboxes

You can connect as many Gmail accounts as you need — each mailbox gets its own connection. Repeat the flow above for each account.
Each Gmail account can be used as a send address, a receiving inbox, or both, depending on the scope you chose.

​
Verify the Connection

  • Connection status on the Connections page should show Active
  • Send a test email from the CRM’s compose UI — the recipient should see it arrive from your Gmail address
  • For read scopes, trigger a test inbound workflow or check the message list in CRM

​
Changing the Scope Later

OAuth tokens are scope-locked. To change a connection from, say, read-only to full access:
1

Disconnect the existing Gmail connection

Click the three-dot menu next to the connection and choose Disconnect.
2

Reconnect with the new scope

Start the flow again from Add Connection > Gmail, pick the new scope, and authorize.

​
Troubleshooting

The Gmail API may be off in your app’s Google Cloud project. Run gcloud services enable gmail.googleapis.com --project=<PROJECT_ID>, or enable the Gmail API in the Google Cloud console, then wait for the next 10-minute check.
The account that signed in is outside the Google Workspace that owns your Gmail app. Sign in as the mailbox itself. See Set up your Gmail app for the other Google errors.
The user revoked access to your Google app at myaccount.google.com/permissions, or the token was invalidated server-side. Reconnect the mailbox to re-issue tokens.
Your Gmail app is External. Make it Internal: in Google Cloud, open Audience and click Make internal, then reconnect the mailbox once. External apps in Testing lose their sign-ins after 7 days.
Tokens are scope-locked — changing scopes requires a fresh authorization. Disconnect the Gmail connection in Hiveku and reconnect with the new scope selected.

​
What’s Next?

Connect Google Calendar

Calendar and Meet for booking, in one click

Run Sales Sequences

Personal OAuth cadences — sent from this Gmail inbox

Work with the AI SDR

The AI drafts and sends from your connected Gmail on approval

Send Emails

Use your Gmail connection in workflows