Gmail Connector

Build in-app mail workflows that send transactional email, surface inbound messages, create drafts and automate labeling for each customer account using the Gmail API.

Build with this Connector Talk to an integration expert

Faster time to market

Prebuilt Gmail actions speed up integration delivery.

Multi-tenant credential handling

Store and rotate customer OAuth credentials securely at scale.

Reusable orchestration

Build once workflows and reuse across customers and products.

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

Overview

Integrate sending, receiving, labeling and mailbox automation for user mailboxes, threads, drafts and settings with Gmail. Cyclr lets teams map events (for example new inbound messages), call Gmail methods to send or modify messages, and orchestrate multi-step workflows including Pub/Sub push notifications and message retrieval.

PRODUCT USE CASES

Top Use Cases for Gmail Integrations

Create transactional email senders, route incoming messages to support systems via Pub/Sub, auto-label or archive messages, and publish integrations into your embedded marketplace for end users to enable per-account Gmail connections.

Send transactional emails from your app

Trigger users.messages.send to deliver transactional messages (notifications, receipts) using the authenticated user’s mailbox.

Create support tickets from inbound mail

Subscribe to mailbox changes with users.watch (Pub/Sub), then list and get new messages to create support tickets.

Auto-label and move messages

Use labels.modify or threads.modify to tag, archive or move customer messages automatically based on workflow rules.

ORCHESTRATION

How Gmail works with Cyclr

Cyclr sits between your SaaS product and Gmail to handle authentication, govern access and orchestrate every API call per customer, at scale.

1
Your SaaS product
Your app requests an action for a specific customer.
2
Cyclr orchestration
Cyclr authenticates, applies policies and routes the request.
3
Gmail
Gmail processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore Gmail methods you can orchestrate through Cyclr.

Emails10

Get Email

Action

Gets the specified email.

Send Email

Action

Sends an email to the specified recipient.

Trash Email

Action

Moves the specified message to the trash.

Send Email with Attachment

Action

Sends an email to the specified recipient with attached file.

Update Emails Batch

Action

Modifies the labels on the specified emails.

Get Email Attachment

Action

Gets an email atachment.

List Emails

Action

Lists the emails in the user's mailbox.

Update Email

Action

Modifies the labels on the specified email.

Untrash Email

Action

Removes the specified message from the trash.

List New Emails

Action

Lists all the emails in the user's mailbox since the last successful run.

Labels5

Update Label

Action

Updates the specified label.

List Labels

Action

List all labels for the specified user.

Get Label

Action

Gets the specified label.

Create Label

Action

Creates a new label.

Delete Label

Action

Deletes the specified label.

Drafts5

List Drafts

Action

Lists the drafts in the user's mailbox.

Send Draft

Action

Sends the specified, existing draft to the recipients in the To, Cc, and Bcc headers.

Get Draft

Action

Gets the specified draft.

Delete Draft

Action

Immediately and permanently deletes the specified draft. Does not simply trash it.

Update Draft

Action

Replaces a draft's content.

Webhooks - Copyable1

Email Notification - Copyable

Webhook

Test1

Post

Action

History1

List Email History

Action

Lists the history of all changes to the given mailbox.

Users1

Get User

Action

Gets the current user's Gmail profile.

TECHNICAL DETAILS

Gmail integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing Gmail integrations in Cyclr.

API and authentication

API host: https://gmail.googleapis.com
Authentication: OAuth 2.0
Credentials: OAuth client ID; OAuth client secret; Cyclr service domain; optional Pub/Sub topic/project for push.
Method categories: Send email; Read messages; Manage labels, threads, drafts; Watch (push) notifications; Manage mailbox settings

View vendor API documentation →

Pagination and rate limits

Pagination

List endpoints use pageToken/nextPageToken pagination; iterate until nextPageToken is absent.

Rate limits

Gmail enforces per-user and per-project quota and concurrent request limits; request quota adjustments in Google Cloud Console.

IMPLEMENTATION

Authentication at a glance

OAuth 2.0 with an OAuth client ID and secret; register a Google Project and set Cyclr redirect URI. Watch for refresh token rules in testing mode.

Authentication method: OAuth 2.0
Credential required: OAuth client ID; OAuth client secret; Cyclr service domain; optional Pub/Sub topic/project for push.

Before you begin:

OAuth consent verification may be required; refresh tokens in Testing expire after seven days.

View setup guide

COMMON QUESTIONS

Frequently asked questions

It can send mail, create drafts, read and list messages, manage labels and threads, and subscribe to mailbox changes for automation. These map to Gmail API methods such as users.messages.send, users.messages.list/get, drafts.create, labels.modify and users.watch.

OAuth 2.0: you register a Google Cloud project, create an OAuth client ID and secret, and add Cyclr’s redirect URI. Expect OAuth consent verification for production and refresh token behavior in Testing mode.

Yes. Cyclr stores per-customer OAuth credentials and runs multi-tenant workflows so each customer connects their own Gmail account within your embedded UI.

Yes. You can expose send, read, label and watch actions as governed, reusable workflow steps in Cyclr’s MCP, with centralized governance of credentials and rate limits.

KEEP EXPLORING

Related resources and connectors

Documentation

Gmail Connector

Faster time to market

Multi-tenant credential handling

Reusable orchestration

Embedded experience

Overview

Top Use Cases for Gmail Integrations

Send transactional emails from your app

Create support tickets from inbound mail

Auto-label and move messages

How Gmail works with Cyclr

Your SaaS product

Cyclr orchestration

Gmail

Available connector capabilities

Get Email

Send Email

Trash Email

Send Email with Attachment

Update Emails Batch

Get Email Attachment

List Emails

Update Email

Untrash Email

List New Emails

Update Label

List Labels

Get Label

Create Label

Delete Label

List Drafts

Send Draft

Get Draft

Delete Draft

Update Draft

Email Notification - Copyable

Post

List Email History

Get User

Gmail integration and API details

API and authentication

Pagination and rate limits

Pagination

Rate limits

Authentication at a glance

Frequently asked questions

Related resources and connectors

Email Marketing Integrations to make your daily tasks easier

What is iPaaS?

MCP PaaS

Act!

ActiveCampaign

Adobe Campaign

Let Cyclr handle the integrations.