Skip to main content

Minotaur × Google Gmail — Integration Guide

App: Minotaur Gmail Integration
Published by: Minotaur Sales
Supported on: app.minotaursales.io

Overview​

The Minotaur Gmail integration connects your Gmail or Google Workspace mailbox to the Minotaur CRM, allowing you to:

  • Send emails to contacts directly from a contact's record, with attachment and open/link tracking.
  • Reply and forward existing email threads without leaving the app.
  • Read a contact's email history — messages between you and that contact are surfaced in the contact's profile.
  • Automatically capture inbound replies — when a contact emails you back, the message is logged as a CRM activity and you receive an in-app notification.

Scope of this integration: Gmail email only. Google Calendar, Google Contacts, and Google sign-in/SSO are not part of this integration.

Prerequisites​

RequirementDetails
Google accountA Gmail account or a Google Workspace (formerly G Suite) account.
Minotaur accountYou must be logged in to app.minotaursales.io and have access to Settings.

No special Google admin configuration is required for personal Gmail accounts. For Google Workspace accounts, your organization's admin may need to allow third-party OAuth applications under Admin Console → Security → API Controls.

Adding the Integration (Install & Connect)​

  1. Log in to app.minotaursales.io.
  2. Navigate to Settings → Connections → Emails.
  3. Click Connect Gmail / Google Workspace.
  4. A new browser tab opens with Google's authorization page. Log in to your Google account (if not already) and review the requested permissions:
    • Read your basic profile info and email address (userinfo.email, userinfo.profile)
    • Read, send, and modify Gmail messages (gmail.readonly, gmail.send, gmail.modify)
  5. Click Allow.
  6. The tab closes and you are redirected back to Minotaur. Your Gmail address now appears as a connected account in the Emails table under Settings → Connections → Emails.

Using the Integration​

Sending Email to a Contact​

  1. Open any contact record.
  2. Click Send Email (or the email icon in the contact's actions).
  3. Your connected Gmail account is available as the sender.
  4. Compose your message (subject, body, attachments) and click Send.
  5. The sent email is logged as an email activity on the contact's timeline.

Replying and Forwarding​

  • Open an email thread in a contact's record.
  • Use the Reply or Forward action to send directly from your Gmail account.

Reading a Contact's Email History​

  • Open a contact record and navigate to the Emails tab (or the activity timeline).
  • Minotaur fetches messages from your Gmail inbox where the contact's email address appears, displaying them in the contact's profile.

Automatic Inbound Email Capture​

When a contact replies to one of your sent emails or sends you a new message, Gmail notifies Minotaur in real time. The inbound message is automatically logged as a CRM activity on that contact's record and triggers an in-app notification. No manual action is needed.

Inbound capture applies to replies to your sent emails and messages from known contacts only (the sender's email must match a contact in Minotaur).

Removing the Integration​

  1. Go to Settings → Connections → Emails.
  2. Find your Gmail account in the table.
  3. Click the delete (trash) icon on that row and confirm.
  4. Minotaur removes the stored OAuth tokens for that account. Future emails and inbound capture for that address are disabled.

Note: Removing the connection in Minotaur does not revoke access at Google's end. To fully revoke access, also visit Google Account Security → Third-party apps and remove Minotaur.

Troubleshooting / FAQ​

"This Gmail account is already connected"​

Each Gmail address can only be connected once per user. Check your existing connections in Settings → Connections → Emails. To reconnect with a different Google account, delete the existing connection first.

My connection shows "Expired" or "Disconnected"​

Go to Settings → Connections → Emails, delete the expired connection, then click Connect Gmail / Google Workspace again.

Inbound emails are not being captured automatically​

  • The sender must be a contact already in Minotaur (their email must match a contact record).
  • Auto-capture applies primarily to replies to emails you sent from Minotaur, or to inbound messages from known contacts.
  • If you recently reconnected, allow a few minutes for the Gmail notification watch to reactivate.

Google Workspace admin blocked the connection​

Ask your admin to allow Minotaur in Admin Console → Security → API Controls → App Access Control.

Data & Privacy​

Data typeHow it is used
Google OAuth access & refresh tokensStored securely in Minotaur's database, scoped to your user. Used only to access Gmail on your behalf.
Google profile (name, email address)Displayed in the connected accounts table. Not shared externally.
Gmail messagesFetched live from Gmail when you view a contact's emails. Sent/received messages are logged as CRM activities. Message content is not bulk-stored in Minotaur's database.
AttachmentsTransmitted via Gmail. Not stored in Minotaur.

Support​

For help with this integration, contact Minotaur support: