Google Gmail integration – Appmixer connector library

Gmail is a free advertising-supported email service provided by Google. Users can access it on the web and through mobile apps, as well as through third-party programs. It's one of the most popular email services in the world.

Changelog

14 versions

v3.1.0 Latest

Added test() (Flow Test Mode) to all triggers: NewEmail, NewAttachment, NewLabel, NewStarredEmail — emit one realistic item via a read-only call, reusing the same lib helpers as tick().

v3.0.0

(breaking change) MakeApiCall: headers and parameters changed to key-value array inputs (body remains textarea/JSON to support nested structures) per standard #1459 — existing flows that used the old string/textarea headers or parameters must be updated

v2.0.9

Added output examples to component schemas.

v2.0.8

Added conditional debug logging to trigger components - debug messages are now disabled by default and can be enabled via DEBUG configuration.

v2.0.7

NewEmail Trigger - Added output port label for Sender's email address and name

v2.0.6

NewEmail Trigger - Added support for input of labels
NewAttachment Trigger - Added support for labels input, filter Emails based on selected filters and fetch their attachments
AddLabelsToEmail Action
DeleteEmail Action
DeleteLabel Action - Input of list of user defined labels added
ListSignatures Action - List default signature from Gmail
SendEmail Action - Added input support for CC, BCC, Labels, Signature
CreateDraft Action - Added input support for CC, BCC, Labels, Attachments, Signature
RemoveLabelFromEmail - new action
GetAttachment - Added support for inputting email ID and then selecting which attachment to download from that email
ReplyEmail - new action
ListAttachments - new action
FindEmails - new action
Breaking change - removal of account from `connected accounts` and re-authentication of Gmail account will be required
DeleteEmail - Breaking Change: Ultimate Scope of mail.google.com added. Will require removal of account from `connected accounts` and re-authentication of Gmail account
CreateDraft - Breaking Change: New Scope of email.modify added. Will require removal of account from `connected accounts` and re-authentication of Gmail account
Breaking change - updating the auth service to appmixer:google:gmail. Will require re authentication
FindOrCreateLabel - NewAction
Moving auth.js from googleapis to httpRequest, improving tooltips and marking fields required
Adding index and total messages count in the output port options of FindEmails
Renamed GetAttachment to DownloadAttachment

v1.2.0

Added attachments in outPorts of GetEmail and NewEmail.
Added 'GetAttachment' component.

v1.1.5

GetEmail: update tooltip.

v1.1.4

Fixed quota issues.

v1.1.3

Added new components.

v1.1.2

Scope for all components reviewed and minimized.

v1.1.1

NewEmail component does not need https://mail.google.com/ scope

v1.1.0

Add Google branded sign-in button.

v1.0.0

Initial version

Authentication

Type	Details
OAuth 2	Authentication Hub Verified This connector is globally authenticated and verified by Appmixer and is ready to use without registering your own OAuth application with the provider. Appmixer's Authentication Hub acts as an authentication proxy, so all OAuth-based connectors work out of the box. You can still use your own OAuth credentials (clientId and clientSecret) for enhanced customization or compliance — see the Connector Configuration section of the documentation. The Authentication Hub is enabled for all hosted Appmixer tenants; on self-managed installations it has to be explicitly set. Scopes: profile email

Triggers

New Attachment

This trigger activates whenever a new attachment is received in your Gmail inbox.

Additional Scopes:

...//www.googleapis.com/auth/gmail.readonly

New Email

Triggers whenever a new email is received or created in your Gmail account. This includes emails across all labels or specific labels as configured.

Additional Scopes:

...//www.googleapis.com/auth/gmail.readonly

New Label

This trigger fires every time any new label is added in your inbox.

Additional Scopes:

...//www.googleapis.com/auth/gmail.readonly

New Starred Email

This trigger fires every time any new starred email arrives in your inbox.

Additional Scopes:

...//www.googleapis.com/auth/gmail.readonly

Actions

Create Draft

Create new draft.

Additional Scopes:

...s://www.googleapis.com/auth/gmail.modify

Create Label

Create new label.

Additional Scopes:

...s://www.googleapis.com/auth/gmail.labels

Add Labels To Email

Adds a label(s) to emails.

Additional Scopes:

...s://www.googleapis.com/auth/gmail.modify

Delete Label

Delete label.

Additional Scopes:

...s://www.googleapis.com/auth/gmail.labels

Delete Email

Delete email from your gmail.

Additional Scopes:

https://mail.google.com/

Download Attachment

Download an email attachment.

Additional Scopes:

...//www.googleapis.com/auth/gmail.readonly

Find Or Create Label

Searches for a Gmail label by name and returns the Label ID if found. If the label is not found, you can choose to automatically create a new label instead of returning a 'Not Found' response. This component offers flexibility in managing your Gmail labels by either retrieving existing labels or seamlessly creating new ones when needed.

Additional Scopes:

...s://www.googleapis.com/auth/gmail.labels

Find Emails

Finds emails in Gmail based on a search query. You can retrieve emails as a single item, multiple items, or save them directly to a file. Each message resource contains only the Email ID and Thread ID. To get detailed information about specific emails, use the Get Email component. For guidance on search queries, refer to the Gmail Search Documentation. This component will return a maximum of 500 records.

Additional Scopes:

...//www.googleapis.com/auth/gmail.readonly