Gmail icon

Gmail

Google's email service — send, read, organize, and search messages, threads, and drafts.

1 trigger6 searches14 actionsPollingAuth: OAuth

AI-assisted documentation8 min read

This documentation is compiled from our integration source code, internal specs for Gmail, its official API documentation and anonymized requests logs we collect from our support team[2].

Open Gmail on WEXTL →

To use Gmail on WEXTL you need an active account and OAuth client credentials, granted by signing in with your account.[3]

You’ll be redirected to sign in and approve access — your password is never shared with WEXTL.

  • Client IDtext

    Optional. Your own OAuth Client ID from Google Cloud Console (enable the API, then Credentials → OAuth client). Leave empty to use the platform app.

    [1]
  • Client Secretpassword

    Optional. Client Secret for the same OAuth client. Leave empty to use the platform app.

    [1]
  • Additional Scopesarray

    Optional. Extra Google OAuth scopes to request on top of the default ones, one full scope URL per item (for example https://www.googleapis.com/auth/drive). Duplicates of the default scopes are ignored. Use this with your own Client ID, and enable the same scopes on its OAuth consent screen.

    [1]
Integration requests 2 permissions:
https://www.googleapis.com/auth/gmail.modifyhttps://www.googleapis.com/auth/gmail.readonly
  1. Log in to your WEXTL account, add the Gmail node module to your workflow, and click Create new credential.
  2. Optional: In the Credential name field, enter a name for the credential.
  3. Enter the authentication credentials you copied from your Gmail account, or follow the on-screen instructions to create the credential.
  4. If prompted, authenticate your account and confirm access.
  5. If you want to make changes to your credential in the future, follow the steps in Manage credentials →
Connecting Gmail to WEXTL®
Video slide demonstrates how to integrate Gmail in the WEXTL visual workflow builder.[4]

Notes

Credentials are org-scoped; share them with teammates from the Credentials picker on any of its nodes.For detailed information on connecting an application, see Connect an application →

Watch Email MessagesTrigger
Output fields[3]
FieldType
IDtext
Thread IDtext
Label idsarray
Snippettext
History IDtext
Internal datedate
Payloadobject
Part IDtext
Mime typetext
Filenametext
Headersarray
Bodyobject
Partsarray
Size estimatenumber
Rawtext
Classification label valuesarray
List Draft EmailsSearch
Input fields[3]
FieldType
Querytext
Include Spam and Trashboolean
Limitnumber
Output fields[3]
FieldType
IDtext
Messageobject
IDtext
Thread IDtext
Label idsarray
Snippettext
History IDtext
Internal datedate
Payloadobject
Size estimatenumber
Rawtext
Classification label valuesarray
List MessagesSearch
Input fields[3]
FieldType
Querytext
Label IDschoice
Include Spam and Trashboolean
Limitnumber
Output fields[3]
FieldType
IDtext
Thread IDtext
Label idsarray
Snippettext
History IDtext
Internal datedate
Payloadobject
Part IDtext
Mime typetext
Filenametext
Headersarray
Bodyobject
Partsarray
Size estimatenumber
Rawtext
Classification label valuesarray
List ThreadsSearch
Input fields[3]
FieldType
Querytext
Label IDschoice
Include Spam and Trashboolean
Limitnumber
Output fields[3]
FieldType
IDtext
Snippettext
History IDtext
Messagesarray
Retrieve a Draft EmailAction
Input fields[3]
FieldType
IDRequired
choice
FormatRequired
choice
Output fields[3]
FieldType
IDtext
Messageobject
IDtext
Thread IDtext
Label idsarray
Snippettext
History IDtext
Internal datedate
Payloadobject
Size estimatenumber
Rawtext
Classification label valuesarray
Retrieve a ThreadAction
Input fields[3]
FieldType
IDRequired
choice
FormatRequired
choice
Output fields[3]
FieldType
IDtext
Snippettext
History IDtext
Messagesarray
Retrieve an Email MessageAction
Input fields[3]
FieldType
IDRequired
choice
Output fields[3]
FieldType
IDtext
Thread IDtext
Label idsarray
Snippettext
History IDtext
Internal datedate
Payloadobject
Part IDtext
Mime typetext
Filenametext
Headersarray
Bodyobject
Partsarray
Size estimatenumber
Rawtext
Classification label valuesarray
Batch Delete Email MessageAction
Input fields[3]
FieldType
Message IDsRequired
choice
Create a Draft EmailAction
Input fields[3]
FieldType
Email ContentRequired
text
Recipient EmailRequired
email
Sender EmailRequired
email
Email SubjectRequired
text
Output fields[3]
FieldType
IDtext
Messageobject
IDtext
Thread IDtext
Label idsarray
Snippettext
History IDtext
Internal datedate
Payloadobject
Size estimatenumber
Rawtext
Classification label valuesarray
Delete a Draft EmailAction
Input fields[3]
FieldType
IDRequired
choice
Delete a ThreadAction
Input fields[3]
FieldType
IDRequired
choice
Delete an Email MessageAction
Input fields[3]
FieldType
IDRequired
choice
Make an API Calluniversal
Input fields[3]
FieldType
URLRequired
text
MethodRequired
choice
Headersarray
Headerobject
Query Stringarray
Parameterobject
Bodytext
Output fields[3]
FieldType
Bodytext
Headersobject
Status codenumber
Send a Draft EmailAction
Input fields[3]
FieldType
IDRequired
choice
Output fields[3]
FieldType
IDtext
Thread IDtext
Label idsarray
Snippettext
History IDtext
Internal datedate
Payloadobject
Part IDtext
Mime typetext
Filenametext
Headersarray
Bodyobject
Partsarray
Size estimatenumber
Rawtext
Classification label valuesarray
Send an Email MessageAction
Input fields[3]
FieldType
ToRequired
email
FromRequired
email
SubjectRequired
text
Email ContentRequired
text
Output fields[3]
FieldType
IDtext
Thread IDtext
Label idsarray
Snippettext
History IDtext
Internal datedate
Payloadobject
Part IDtext
Mime typetext
Filenametext
Headersarray
Bodyobject
Partsarray
Size estimatenumber
Rawtext
Classification label valuesarray
Trash a MessageAction
Input fields[3]
FieldType
IDRequired
choice
Output fields[3]
FieldType
IDtext
Thread IDtext
Label idsarray
Snippettext
History IDtext
Internal datedate
Payloadobject
Part IDtext
Mime typetext
Filenametext
Headersarray
Bodyobject
Partsarray
Size estimatenumber
Rawtext
Classification label valuesarray
Trash a ThreadAction
Input fields[3]
FieldType
IDRequired
choice
Output fields[3]
FieldType
IDtext
Snippettext
History IDtext
Messagesarray
Untrash a MessageAction
Input fields[3]
FieldType
IDRequired
choice
Output fields[3]
FieldType
IDtext
Thread IDtext
Label idsarray
Snippettext
History IDtext
Internal datedate
Payloadobject
Part IDtext
Mime typetext
Filenametext
Headersarray
Bodyobject
Partsarray
Size estimatenumber
Rawtext
Classification label valuesarray
Untrash a ThreadAction
Input fields[3]
FieldType
IDRequired
choice
Output fields[3]
FieldType
IDtext
Snippettext
History IDtext
Messagesarray
Update a Draft EmailAction
Input fields[3]
FieldType
IDRequired
choice
Raw MessageRequired
text
Recipient EmailRequired
email
Sender EmailRequired
email
Email SubjectRequired
text
Email ContentRequired
text
Output fields[3]
FieldType
IDtext
Messageobject
IDtext
Thread IDtext
Label idsarray
Snippettext
History IDtext
Internal datedate
Payloadobject
Size estimatenumber
Rawtext
Classification label valuesarray
Update a Thread’s LabelsAction
Input fields[3]
FieldType
IDRequired
choice
Add Label IDsarray
Label IDtext
Remove Label IDsarray
Label IDtext
Output fields[3]
FieldType
IDtext
Snippettext
History IDtext
Messagesarray

Look for Gmail templates in the WEXTL template library.

Browse templates →
  1. WEXTL® Gmail Source Code connector implementation.
  2. Our users use cases and automations.
  3. Official API Documentation for Gmail.
  4. WEXTL® visual workflow builder data.

Last updated: Jul 21, 2026 15:22