Note: Use and transfer of information received from Google APIs to any other app will adhere to Google API Services User Data Policy, including the Limited Use requirements.

Google Mail

The Google Mail connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores. is used to create connections for Google Mail actions and data sources. Use Google Mail actions A tool for building the processes, logic, and direction within workflows. to get messages, threads, and labels, and to delete a message from a user's mailbox in Google Mail. In the context of Nintex Automation Cloud, Google Mail is a connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores.. Google Mail is an email service developed by Google that allow users to access Google Mail on the web. Google Mail uses third-party programs that synchronize email content through POP or IMAP protocols. You can also chat, make voice or video calls, and stay on top of project work with shared files and tasks. For more information, see Google Mail.

Jump to:

Create a Google Mail connection

Note: Your browser-stored credentials are accessed to create connections. Either clear credentials from browser memory or make sure the stored credentials are for the intended environment.

Create a connection from the connections page or from the action configuration panel when configuring the action. For information about creating connections and assigning permissions, see Manage connections.

Google Mail account requirements: 

  • Nintex Automation Cloud uses the app Nintex Automation Cloud - Google Mail Connector to create Google Mail connections. This app requires you to grant permissions to read, compose, send, delete mail and view your email messages and settings.
  • The account you use to create a connection for Google Mail is the account that has access to the Google Mail actions.
  • Before you create your connection, you must configure Nintex Connector - Mail as a trusted app in your Google Workspace to comply with Google's security restrictions.

    1. From Google Admin, go to Security>API controls.
    2. On the App access control page, click Manage third-party app access in the Overview section.
    3. Click Change access next to the Nintex Connector - Mail app.
    4. In the Change access dialog, select Trusted: Can access all Google services and then click Change.

Create a Google Mail data source

Use the Google Mail connector to create a data source to retrieve data from Google Mail. Data sources are useful when you want to use a form in a workflow, and you want to populate a drop-down list in your form with data from Google Mail. Each data source is configured for a specific account. You can create as many data sources as you need. For more information on creating a data source and assigning permissions to it, see Data sources.

Once you've created the data source, you can use it in a Data lookup control A form control that allows users to select from a drop-down list of values that have been fetched from a third-party service.. to populate the drop-down list field on your form.

You can create a data source to:

  • Get labels - Use this operation if you want to retrieve a list of all labels from a user's mailbox.
  • Get messages - Use this operation if you want to retrieve a list of all the messages in a user's mailbox.
  • Get threads - Use this operation if you want to retrieve a list of all the message threads in a user's mailbox.

Data source fields

When you create a Google Mail data source, you can configure additional fields.

To access the data source fields, in the Add data source section, select the Connector and the Operation.

The following operations are available for the Google Mail connector:

  • Google Mail - Get labels

  • Google Mail - Get messages

  • Google Mail - Get threads

The configuration fields displayed depend on the operation selected.

Operation

Field or selection

 Description
Google Mail - Get labels

Email

Type the email address of the user for whom you want to retrieve a list of labels. Using 'me' will use the authenticated user's default email account.
Google Mail - Get messages

Email

 Type the email address of the user for whom you want to retrieve messages. Using 'me' will use the authenticated user's default email account.
  Item limit Select the value for the maximum number of messages to be retrieved.
  Query Type a query to retrieve messages. This field is optional. If you specify a Query, the data source will only retrieve messages matching the specified query. Supports the same query format as the Gmail search box. Your query should contain a field, operator and value. For more information see the Gmail API. For example, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".
  Page token

Retrieves the next page of messages. Use the

Page token output from a previous

Google Mail - Get messages action.

You can use the Next page token output of a previous Google Mail - Get messages action to retrieve the next page of results.
Google Mail - Get threads

Email

Type the email address of the user for whom you want to retrieve message threads. Using 'me' will use the authenticated user's default email account.
  Item limit Select the value for the maximum number of message threads to be retrieved.
  Query Type a query to retrieve message threads. This field is optional. Supports the same query format as the Gmail search box. If you specify a Query, the data source will only retrieve message threads matching the specified query. Your query should contain a field, operator and value. For example, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".
  Page token

Retrieves the next page of message threads. Use the Page token output from a previous Email: Type the email address of the user for whom you want to retrieve messages. Using 'me' will uus

Google Mail - Get threads

action.

You can use the Next page token output of a previous Google Mail - Get messages action to retrieve the next page of results.
  Labels Restricts the records retrieved to threads that include labels such as INBOX, SENT, SPAM, TRASH.