Communications Mining Activities

Last updated Apr 1, 2026

Uploading the data with an automation

When uploading messages to Communications Mining™, the automation process involves three main stages. First, you'll read a batch of messages from your communications channel, such as fetching unread emails from Gmail. Next, you'll convert these communications into Communications Mining records using the Create Record activity. Finally, you'll upload this list of records to Communications Mining with the Upload Records activity.

Note: When possible, work with batches of communications rather than processing them one at a time. This approach significantly boosts performance.

Uploading new emails from Gmail using Studio Web

Make sure you have already configured your connection to Gmail in Integration Service.
Make sure you have already set up your target source within Communications Mining™.

Create your Studio Web Project
First, create a new project which is triggered by Google Workspace: Email Received
Connect your trigger to your existing connection

Select the connection that you want to use for the mailbox that you want to monitor.
Add a Create Record activity

Add the Communications Mining Create Record activity as the next step in your automation.
Provide your field mapping

Within the Create Record activity, map each of your fields.

Note: When creating a record based on email data:

The Record ID should be the MIME Internet Message ID
The Thread ID should be the content of the References header on the email
You may need to map a list of recipient email addresses to a semi colon separated string as shown in the screenshot.

Provide your user properties
Expand the User-defined string properties section and provide any user properties that you want to be associated with your communication.
Add an Upload Record(s) activity

Add the Communications Mining Upload Record activity.
Configure Upload Record

Select the project and source for your target source and enter the record that was created in the Create Record step into the Record field.
Run and test your process

Your process should now be uploading new emails received into Gmail and upload them into Communications Mining™.

Uploading historic Gmail emails with Studio Desktop

Make sure you have already configured your connection to Gmail in Integration Service.
Make sure you have already set up your target source within Communications Mining™.

Add a For Each Email Gmail activity
Add the For Each Email Gmail activity to a new process, configure the activity to use your existing connection, and add any preferred filters.
Add a Create Record activity
Within the body of your For Each Email activity, add the Communications Mining Create Record activity.
Provide your field mapping
Within the Create Record activity, map each of your fields on the activity. Find additional fields in the properties panel. Save the output in a variable called CurrentRecord.
Note: When creating a record based on email data:
- The Record ID should be the MIME Internet Message ID
- The Thread ID should be the content of the References header on the email
- You may need to map a list of recipient email addresses to a semi colon-separated string as shown in the following image.
Provide your user properties
Expand the User-defined properties section and provide any user properties that you want to associate with your communication.
Create a list to store your Record in for later
Create a new variable called RecordList and give it the type List<Record>. This variable should have a default value of an empty list.
Append your Current Record to your Record List
Add an Append Item to List activity to your process and append the CurrentRecord to your RecordList.
Note: The Append Item to List activity must have the type argument Record. You can set this in the properties panel.
Add an Upload Record(s) activity
After the For Each Email activity, add a Communications Mining™ Upload Record(s) activity.

Note:
Communications Mining™ does the upload upload after each loop to make this process as quickly as possible.
Configure Upload Record
Select the project and source for your target source and enter the record that was created in the Create Record step into the Record field.
Run and test your process
Your process should now be uploading new emails received into Gmail and upload them into Communications Mining™.

On this page

Uploading new emails from Gmail using Studio Web
Uploading historic Gmail emails with Studio Desktop

Was this page helpful?

PREVIOUSHow communications are uploaded into the platform

NEXTHow the Dispatcher process works