Gmail Connector Reference

Gmail is a popular email service used by businesses for a large number of communication purposes. This connector enables productivity by connecting a user’s inbox to other systems like Google Sheets, Salesforce, or Slack.

Before You Begin

The Composer Gmail Connector requires third-party app access to access restricted data in Google. Before using the connector, your Google Workspace administrator must add one of the following Client IDs to the list of configured apps to create Gmail OAuth connections with Composer:

  • Production Environment United States: 14294369739-rn5ftpjat2mnofvp3gevkvmik0roioe7.apps.googleusercontent.com

  • Production Environment Europe: 14294369739-028kk1tl316tgo3a59rtpl6qq6u22d25.apps.googleusercontent.com


To connect to a system, whether it is a source of data or the target where you are sending data, you must create a connection with that system’s required credentials. You typically connect to different systems within a flow and can reuse each connection every time you need to connect.

This system requires the following credential information for its connections:

Connection Name

Enter a connection name that will help you remember the details of this connection. You can reuse connections multiple times in a single flow, and in more than one flow, and the credentials are hidden after you create the connection. Therefore, it’s helpful to provide a name that easily identifies this connection from others.

Only you can see the connection. Other users in your Composer app must create their own connections.


The OAuth username that you use to log in to Google.


The OAuth password that you use to log in to Google.


Each flow starts with a scheduler that specifies a time span for how frequently the flow starts or with a trigger that you define, such as "each time a new record is created." Triggers provide multiple options related to the data in your system.

Triggers execute every ten minutes.

This system provides the following trigger options:

New email

This trigger fires when a new email is received in the user’s inbox.


After you connect to a system and define the trigger or configure a scheduler, you define the actions that the flow performs, such as copying a record from Workday to Salesforce. The actions you can perform depend on which system you are connected to.

This system provides the following actions:

Send email

Sends an email with up to one attachment link. The following fields are required:

  • To

  • Subject

  • Body

The Google Gmail connector’s use and transfer to any other application of information received from Google APIs is subject to the Google API Services User Data Policy, including the Limited Use requirements.

Gmail™ is a trademark of Google LLC.

Was this article helpful?

💙 Thanks for your feedback!

Edit on GitHub
Submit your feedback!
Share your thoughts to help us build the best documentation experience for you!
Take our latest survey!