Gmail

Gmail is one of the primary email channels in Auxx.ai. Once connected, incoming messages sync into your shared inbox and you can reply directly from the platform. Auxx.ai supports both platform-managed credentials and bring-your-own-credentials (BYOC) for Google OAuth.

Connect Gmail

The quickest way to connect is through the standard OAuth flow using Auxx.ai's platform credentials.

For detailed steps on linking your channel to a shared inbox and configuring settings, see Connect your first inbox.

Permissions requested

Auxx.ai requests the following access to your Google account:

Offline access

Auxx.ai requests offline access so it can continue syncing messages in the background using a refresh token, even when you're not actively signed in. This is how background sync and real-time notifications work.

Set up your own Google credentials (BYOC)

Prerequisites

• A Google Cloud project (new or existing)
• Access to the Google Cloud Console

Step-by-step

1. Create a Google Cloud project (or use an existing one)

   • Go to Google Cloud Console
   • Click the project dropdown at the top and select New Project
   • Give it a name (e.g., "Auxx Mail Integration") and click Create

2. Enable the Gmail API

   • In your project, go to APIs & Services > Library
   • Search for "Gmail API" and click Enable

3. Configure the OAuth consent screen

   • Go to APIs & Services > OAuth consent screen
   • Select External user type and click Create
   • Fill in the required fields:
     • App name: e.g., "Auxx Mail Integration"
     • User support email: your email address
     • Developer contact information: your email address
   • On the Scopes step, click Add or Remove Scopes and add:
     • https://www.googleapis.com/auth/gmail.modify
     • https://www.googleapis.com/auth/gmail.send
     • https://www.googleapis.com/auth/gmail.labels
   • On the Test users step, click Add users and enter the Gmail address you'll be connecting
   • Click Save and Continue through the remaining steps

4. Create OAuth credentials

   • Go to APIs & Services > Credentials
   • Click Create Credentials > OAuth client ID
   • Application type: Web application
   • Under Authorized redirect URIs, click Add URI and enter:

     https://app.auxx.ai/api/google/oauth2/callback

   • Click Create
   • Copy the Client ID and Client Secret from the confirmation dialog

5. Enter credentials in Auxx.ai

   • Go to Settings > Channels > New Channel > Gmail
   • You'll see the BYOC credential form
   • Paste your Client ID and Client Secret
   • Confirm you've added the redirect URI shown in the form
   • Click Save & Connect
   • Complete the Google OAuth consent flow

Troubleshooting BYOC

Features

Sync modes

How messages sync depends on which credentials you're using:

Push notifications deliver messages faster, but polling still keeps your inbox up to date within a short delay.

Labels

Gmail labels are synced and available as filters in Auxx.ai. When a label is applied or removed in Gmail, the change is reflected in Auxx.ai and vice versa.

Email aliases

If your Gmail account has send-as aliases configured, Auxx.ai detects them during the connection process. You can send replies from any of your verified aliases.

Re-authentication

Your Gmail connection may need to be re-authenticated if:

• Your Google refresh token expires or is revoked
• You change your Google account password
• You remove Auxx.ai's access from your Google account permissions
• You rotate your BYOC Client ID or Client Secret

When re-authentication is needed, Auxx.ai shows a banner prompting you to reconnect. Click the banner and complete the OAuth flow again — your existing settings and inbox links are preserved.

Next steps