Documentation
Log inAcademyWhat's new?
Back
Artisan IMG > Gmail (gmail)
OverviewOperations
Artisan IMG > Gmail (gmail)

Gmail
4.0

Fast, searchable email with less spam.

Overview
Copy

Use the Tray.io Gmail connector to list, send and download emails as well as change system preferences.

API Information
Copy

The Gmail connector has the following Base URL: https://www.googleapis.com/gmail/v1. More information can be found on their main API documentation (v1) site. Details regarding their API limitations can be found here.

Authentication
Copy

Before authenticating this Google connector, you will need to whitelist the Tray.io Google authentication app. Please follow the instructions here before continuing with the authentication process.

Also note that the connector does not support personal gmail accounts. You should have a gmail for business

Once this is done, you can click on the New Authentication button:

A window appears displaying what scopes will be requested for your account. Tick accordingly and continue.

After being redirected to Google, click on the Allow button found at the bottom of the window.

The authentication process has been completed and the connector can now be used.

Notes on using Gmail
Copy

Sending one email to multiple inboxes
Copy

There may be an occasion where you will wish to send one email to multiple email addresses.

In this use case you have three options to choose from. You don't need to know the exact number of email addresses you will need to send your email to, for any of them before setting up.

This is based on the fact that the list of multiple email addresses you create will be returned as an array and array can be populated with one or several items.

Your options are as follows:

  1. Via the Property Panel: Pass the data direct to the highest property of the properties panel - as long as you format the data correctly.

  2. Use Connector Helpers: If you pass an array to either of them then they will return a string version of the listed email address.

  3. JSONata: Solution:

    1
    $$ @ $data.{
    2
       "to": $data.custom."Primary Customer Contact" = true ? $data.email : null
    3
    }[to != null]

Downloading file attachments
Copy

If you want to download an attachment from an email note that the download will get saved in a file format

You will need to use the File helper to download the attachment properly (and in the desired format).

Example 1 - Sending an email
Copy

This example will walkthrough how to send an email using the Gmail connector.

The first step is to select the Send email operation.

Here, a subject and an email body has been defined. This has been done using the subject and body input fields.

The next step is to configure the address that will be sending the email, and the address that will be receiving the email.

The email is now ready to be sent. To do so, the workflow is ran and as can be seen it has been successful in sending the email.

Below, you can also see the email that was sent on an email client.

Next

Operations