Read, organize and send mail through a verified Google mailbox.
Explore 41 workflow actions for Gmail, including account permissions and operation limits.
14 read actions27 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Add labels to message
Write
Apply one or more labels to a message.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Add labels to thread
Write
Apply labels to every message in a thread.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Archive message
Write
Remove a message from Inbox.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create draft
Write
Compose an unsent plain-text or HTML draft from the connected mailbox.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Without attachments. Choose plain text or HTML for the message body.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create draft with attachments
Write
Compose an unsent plain-text or HTML draft with protected workflow files.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
One to five protected files up to 8 MB total. The encoded request is capped at 16 MB.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create label
Write
Create a custom mailbox label.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete draft
Write
Permanently delete an unsent draft.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
This permanently deletes the draft and cannot be undone.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete label
Write
Permanently remove a custom label from the mailbox.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
This removes the label from all messages and cannot be undone. Gmail refuses deletion of system labels.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get draft
Read
Read an unsent draft and its message metadata.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Get label
Read
Read a label and its message counts.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Get mailbox profile
Read
Read the connected mailbox address and current history cursor.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Get many messages
Read
Find one bounded page and read each matching message's metadata or content.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Reads at most 20 messages per page. Large message bodies may exceed NodeHub's 2 MB provider response limit.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Get many threads
Read
Find one bounded page and read each matching conversation's messages.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Reads at most 20 threads per page. Large conversations may exceed NodeHub's 2 MB workflow result limit.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Get message
Read
Read a message's metadata and parsed content.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Get message attachment
Read
Read an attachment body from a message.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Returns base64url content. NodeHub's provider response limit is 2 MB; larger attachments cannot be read through this action.
Get thread
Read
Read a conversation and its messages.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
List drafts
Read
Read one page of unsent drafts.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List labels
Read
Read the mailbox's system and custom labels.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
List mailbox history
Read
Read one page of mailbox changes after a history cursor.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
An expired cursor returns HTTP 404. Perform a new mailbox baseline before continuing.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List messages
Read
Find one page of messages in the connected mailbox.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
The list returns IDs and thread IDs. Use Get message for content.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List threads
Read
Find one page of conversations.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Mark message read
Write
Remove the UNREAD label from a message.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Mark message unread
Write
Apply the UNREAD label to a message.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Modify labels on many messages
Write
Add or remove labels on a bounded set of messages.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Changes up to 100 message IDs in one request. Gmail confirms acceptance with an empty success response, not an item-by-item receipt.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Permanently delete message
Write
Immediately delete one Gmail message, bypassing Trash. This cannot be undone.
Permissions and limits
Account permissions
https://mail.google.com/
Operation limits
Requires an explicitly authorized full-mailbox Gmail connection. This permanently deletes the selected message and cannot be undone.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Permanently delete thread
Write
Immediately delete a Gmail thread and all its messages, bypassing Trash. This cannot be undone.
Permissions and limits
Account permissions
https://mail.google.com/
Operation limits
Requires an explicitly authorized full-mailbox Gmail connection. Every message in the thread is permanently deleted and cannot be recovered.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Remove labels from message
Write
Remove one or more labels from a message.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Remove labels from thread
Write
Remove labels from every message in a thread.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Rename label
Write
Change a custom label's display name.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reply in thread
Write
Send a plain-text or HTML reply into a known Gmail thread using its RFC Message-ID and matching subject.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
The caller supplies one to 20 recipients, exact matching subject, Gmail thread ID and RFC Message-ID from an earlier read. Gmail decides whether the reply joins the thread. Without attachments.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reply to message
Write
Reply to a Gmail message using its saved thread and message headers.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Reads selected message metadata, decodes bounded UTF-8 or Latin encoded-word subjects, then sends one plain-text or HTML reply. Reply all includes original To and Cc recipients, excluding the connected mailbox and duplicates, up to 20 per destination field. It requires an RFC Message-ID. Gmail decides whether the reply joins the thread. No attachments.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reply with attachments
Write
Reply to a selected Gmail message with protected workflow files.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Reads bounded message metadata, optionally includes original To and Cc recipients for reply all, and decodes UTF-8 or Latin encoded-word subjects before sending one reply with one to five protected files up to 8 MB total.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Restore message
Write
Move a message out of Trash.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Restore thread
Write
Move a conversation out of Trash.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Review aging unread Gmail messages
Read
The authorized user's inbox only. Unread message IDs received 2 days ago through the selected lookback. No bodies, subjects or addresses.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.readonly
Operation limits
Read-only bounded report for the authorized user only. No writes, shared mailboxes or secondary calendars. A partial page is explicitly marked. Mail is unread, not proven unanswered. Overlap is not proven scheduling error.
Pagination: limited. Check the result for additional pages; a single action may not return every record.
Send draft
Write
Send an existing draft to its saved recipients.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send email
Write
Compose and send a plain-text or HTML email from the connected account.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Without attachments. This action starts a new message and does not build reply headers.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send email and wait for response
Write
Send a Gmail message with optional protected files and a link to a NodeHub response page, then wait for an approval, text answer or form submission.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
The recipient follows a link to NodeHub's response page. Replies within Gmail are not captured. The page must be reachable from the recipient's device.
Optional one to five protected files, up to 8 MB total and 16 MB encoded request.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send email with attachments
Write
Send a plain-text or HTML email with protected workflow files attached.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
One to five protected files up to 8 MB total. The encoded request is capped at 16 MB. This starts a new message, not a reply.
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Trash message
Write
Move a message to Trash.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Trash thread
Write
Move a conversation to Trash.
Permissions and limits
Account permissions
https://www.googleapis.com/auth/gmail.modify
Operation limits
Writes are sent once. If Google's reply is lost, NodeHub leaves the step uncertain instead of sending it again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Gmail. A saved workflow is not a completed provider action.
Communication ยท CONNECTION
