Table of Contents

Gmail

Active with remarks
This application needs additional settings. Please follow the documentation below to create your own connectionUnique, active service acces point to a network. There are different types of connections (API key, Oauth…). More.

Redirect url

https://integrator.boost.space/oauth/cb/google-restricted

Gmail

	Important
Any references to third-party products or services do not constitute Celonis Product Documentation nor do they create any contractual obligations. This material is for informational purposes only and is subject to change without notice. Celonis does not warrant the availability, accuracy, reliability, completeness, or usefulness of any information regarding the subject of third-party services or systems.

Important

Any references to third-party products or services do not constitute Celonis Product Documentation nor do they create any contractual obligations. This material is for informational purposes only and is subject to change without notice. Celonis does not warrant the availability, accuracy, reliability, completeness, or usefulness of any information regarding the subject of third-party services or systems.

With the Gmail modulesThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More in Boost.spaceCentralization and synchronization platform, where you can organize and manage your data. More IntegratorPart of the Boost.space system, where you can create your connections and automate your processes. More, you can watch, move, send, copy, delete emails, create draft emails, mark emails as read, unread, modify email labelsA label is a “tag” that can be added to items within a module. It's a flexible tool used to categorize and organize data, making it easier to customize workflows and processes. More, and iterate attachments.

To get started with the Gmail app, create an account at accounts.google.com.

Connecting Gmail to Boost.space Integrator

To connect your Gmail account to Boost.space Integrator as a Google Workspace userCan use the system on a limited basis based on the rights assigned by the admin. More (formerly G Suite), follow the general instructions for Connecting to services.

If you are a @gmail.com or @googlemail.com user, you’ll need to create an OAuth client on the Google Cloud Platform to obtain the Client ID and Client Secret.

For step-by-step instructions on creating OAuth client (and obtaining the Client ID and Client Secret), refer to the Connecting Boost.space Integrator To Google Services Using a Custom OAuth Client, or watch the video tutorial below.

To find out whether you are a G Suite user or @gmail user, please see the Google API restrictions (Do I have a G Suite account? question from the FAQ section) article.

Did You Know?

You can find more than 40 predefined Gmail sample templatesTemplates are predefined scenarios that you can expand and customize to create new scenarios. You can then share these with friends and colleagues. More at www.make.com/en/templatets.

Triggers

Watch Emails

Connection	Establish a connection to your Google account.
Folder	Select the email folder you want to watch.
Filter type	Select the Simple filter option to filter emails by selecting Criteria,or the Gmail filter option to filter emails by entering Query.
Query	Use Gmail search syntax. For example, to search for messages in theSocial category that include an attachment, use `category:social has:attachment`. For more information, visit the Search operators you can use with the Gmail page. If you want to search messages that include an icon of a specific color, please use the following for your search query (specifically what comes after the colon): Yellow Star: `l:^ss_sy` Blue Star: `l:^ss_sb` Red Star: `l:^ss_sr` Orange Star: `l:^ss_so` Green Star: `l:^ss_sg` Purple Star: `l:^ss_sp` Red Bang: `l:^ss_cr` Yellow Bang: `l:^ss_cy` Blue Info: `l:^ss_cb` Orange Guillment: `l:^ss_co` Green Check: `l:^ss_cg` Purple Question: `l:^ss_cp`
*Mark email message(s) as read when fetched*	Select whether or not you want to mark retrieved emails as read.
Maximum number of results	Set the maximum number of results that Boost.space Integrator will work with during one cycleA cycle is the operation and commit/rollback phases of scenario execution. A scenario may have one or more cycles (one is the default)..

Actions

Send an Email

Connection	Connecting Gmail to Boost.space Integrator
To	Enter the email address of the recipient(s) using the Add recipient button.
Subject	Enter the email subject.
Content	Enter the email content (message body). HTML tags are allowed.
Attachments	Add an attachment using the Add an attachment button. You can map a file from the previous modules. Set Content-ID (e.g., `ii_jrc3r9mw1`) if you want to attach inline images (embedded into content). You can put anything here, for example, “`ii_jrc3r9mw1.`” This allows you to create an ID for the attachment, which you can then use in HTML like this: `<img src="cid:ii_jrc3r9mw1">` More information about working with files.
Copy recipients	Add the copy recipient(s). (CC:)
Blind copy recipients	Add the blind copy recipient(s). (BCC:)

Create a Draft

Connection	Connecting Gmail to Boost.space Integrator
Folder	Select the Gmail folder you want to create a draft.
To	Enter the email address of the recipient(s) using the Add recipient button.
Subject	Enter the email subject.
Content	Enter the email content (message body). HTML tags are allowed.
Attachments	Add an attachment using the Add an attachment button. You can map a file from the previous modules. More information about working with files.
Copy recipients	Add the copy recipient(s). (CC:)
Blind copy recipients	Add the blind copy recipient(s). (BCC:)

Mark an Email as Read

Connection	Connecting Gmail to Boost.space Integrator
Folder	Select the Gmail folder that contains the email.
Email ID (UID)	Enter or map the Email ID.

Mark an Email as Unread

Connection	Connecting Gmail to Boost.space Integrator
Folder	Select the Gmail folder that contains the email.
Email ID (UID)	Enter or map the Email ID of the email you want to mark as unread.

Move an Email

Connection	Connecting Gmail to Boost.space Integrator
Folder	Select the Gmail source folder that contains the email you want to move.
Destination folder	Select the Gmail target folder you want to move the email to.
Email ID (UID)	Enter or map the Email ID of the email you want to move.

Copy an Email

Connection	Connecting Gmail to Boost.space Integrator
Folder	Select the Gmail source folder that contains the email you want to copy.
Destination folder	Select the Gmail target folder you want to copy the email to.
Email ID (UID)	Enter or map the Email ID of the email you want to move.

Delete an Email

Connection	Connecting Gmail to Boost.space Integrator
Gmail Message ID	Enter or map the Email ID of the email you want to delete.
Permanently	Permanently removes the message instead of moving it to the trash folder.

Modify Email Labels

Connection	Connecting Gmail to Boost.space Integrator
Gmail Message ID	Enter or map the Email ID of the email you want to delete.
Labels to add	Select the labelA label is a “tag” that can be added to items within a module. It's a flexible tool used to categorize and organize data, making it easier to customize workflows and processes. More you want to add to the selected email message.
Labels to remove	Select the label you want to remove from the selected email message.

Label to add and Label to remove fields load only user-created labels.

Iterators

Iterate Attachments

For more information on Iterators, see Iterator.

Source moduleThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More

Select the module you want to iterate attachments from. You can further process attachments using Dropbox>Upload a file, for example.

Tips & Tricks

To insert your default signature and company logo into Gmail’s Send an email module:

1. First, you will need to use the Watch emails module to retrieve an email that contains your signature and logo. Then, copy the HTML content from the output bundleA bundle is a chunk of data and the basic unit for use with modules. A bundle consists of items, similar to how a bag may contain separate, individual items. More as shown below:

2. Then, in the body field of the Send an email module, copy and paste the HTML content, or edit until you are left with a similar HTML code:

<div dir="ltr"> <div> <div> <div class="gmail_signature" dir="ltr" data-smartmail="gmail_signature"> <div dir="ltr">{{5.text}}</div> <div dir="ltr">&nbsp;</div> <div dir="ltr">Boost.space Integrator. <div>&nbsp;</div> <div><img src="https://docs.google.com/uc?export=download&amp;id=1u7XHeheTZrg5T7f54lRlOX2COwtZYiwU&amp;revid=0B4M0OPcY34MDeko1L0pCYXNlc1RXN0szUFJMNjhMRmcyNXZrPQ" /></div> </div> </div> </div> </div> </div>

3. After you have adjusted the code, proceed to map the text content in the body field from the relevant elements in the appropriate HTML field.

Troubleshooting

Failed to verify connection ‘My Google Restricted connection’. Status Code Error: 400

Your connection has expired and is no longer valid. You need to reauthorize the connection.

This errorService is unavailable due to a failure, a service responds with unexpected data or the validation of input data fails. More affects non-Google Workspace accounts. For more details please refer to the Google OAuth documentation.

Solution

Reauthorize your Google connection.

1. Log in to Boost.space Integrator.

2. Navigate to Connections.

3. Find your Google connection and click Reauthorize button.

To prevent the expiration of your Google connection, we suggest you to reauthorize the connection every week.