Skip to main content
Gmail is Google’s email service, available to individuals and as part of Google Workspace. With BonData, you can connect to your Gmail account to read messages and send email as part of Agent workflows - using it both as a data source and as a notification channel.

​
Gmail OAuth Setup

BonData connects to Gmail using OAuth 2.0, so you authorize access with your Google account without sharing your password.

​
Step 1: Start the Connection

  1. In BonData, navigate to Integrations and select Gmail
  2. Click Connect with Google

​
Step 2: Sign In with Google

  1. You’ll be redirected to Google’s secure sign-in page
  2. Choose the Google account you want to connect
  3. If you belong to multiple Google Workspace accounts, select the correct one

​
Step 3: Grant Access

  1. Review the permissions BonData requests
  2. Click Allow to grant access
  3. You’ll be redirected back to BonData once the connection is authorized
BonData requests scopes to read your mail (gmail.readonly) and to send email on your behalf (gmail.send). You can review or revoke access at any time from your Google account permissions.
Because Gmail is both a data source and a send channel, you can build workflows that read incoming messages, act on them, and reply or notify a recipient - all within a single Agent.

​
Required Fields

OAuth authentication is handled entirely through Google. No additional fields are required after you authorize the connection.

​
Available Data

Once connected, BonData can sync the following Gmail data:
  • Messages - Emails from your mailbox, including headers and body
  • Threads - Conversations grouping related messages
  • Labels - Your Gmail labels and folder structure
  • Drafts - Unsent draft messages
BonData can also send email as an action, letting Agents deliver notifications and replies directly from your Gmail account.