Navigation

Mobile Docs

Gmail

Integrate Gmail functionality into your workflow. Send, read, search, reply, forward emails, manage labels, and more using OAuth authentication.

Toolsgmail

Usage

01Add the block to your workflow and connect it to the upstream step.
02Connect the required credentials or OAuth provider before running.
03Fill in required inputs and optional parameters for the run.
04Run a test execution, inspect outputs, and iterate before deploying.
05Deploy the gmail block with monitoring enabled in production.

Inputs (UI)

Operation

dropdown

Layout: full

Options: Send Email, Read Emails, Search Emails, Reply to Email

Gmail Account

oauth-input

Placeholder: Select Gmail account

Layout: full

Provider: google-email

To

short-input

Placeholder: Recipient email address

Layout: full

Condition: operation = "send_gmail"

Subject

short-input

Placeholder: Email subject

Layout: full

Condition: operation = "send_gmail"

Body

long-input

Placeholder: Email content

Layout: full

Condition: operation = "send_gmail"

Label

folder-selector

Placeholder: Select Gmail label/folder

Layout: full

Provider: google-email

Condition: operation = "read_gmail"

Unread Only

switch

Layout: full

Condition: operation = "read_gmail"

Number of Emails

short-input

Placeholder: Number of emails to retrieve (default: 1, max: 10)

Layout: full

Condition: operation = "read_gmail"

Message ID (Optional)

short-input

Placeholder: Enter message ID to read a specific email

Layout: full

Condition: operation = "read_gmail"

Search Query

short-input

Placeholder: e.g., from:user@example.com subject:invoice is:unread

Layout: full

Condition: operation = "search_gmail"

Max Results

short-input

Placeholder: Maximum number of results (default: 10)

Layout: full

Condition: operation = "search_gmail"

Message ID

short-input

Placeholder: ID of the message to reply to

Layout: full

Condition: operation = "reply_gmail"

Reply Body

long-input

Placeholder: Reply content

Layout: full

Condition: operation = "reply_gmail"

Reply All

switch

Layout: full

Condition: operation = "reply_gmail"

Message ID

short-input

Placeholder: ID of the message to forward

Layout: full

Condition: operation = "forward_gmail"

Forward To

short-input

Placeholder: Recipient email address

Layout: full

Condition: operation = "forward_gmail"

Additional Message (Optional)

long-input

Placeholder: Optional message to include with forwarded email

Layout: full

Condition: operation = "forward_gmail"

Message ID

short-input

Placeholder: ID of the message to trash or restore

Layout: full

Condition: operation = "trash_gmail"

Restore from Trash

switch

Layout: full

Condition: operation = "trash_gmail"

Message ID

short-input

Placeholder: ID of the message to modify

Layout: full

Condition: operation = "modify_labels_gmail"

Add Labels

short-input

Placeholder: Comma-separated label IDs (e.g., STARRED, IMPORTANT, UNREAD)

Layout: full

Condition: operation = "modify_labels_gmail"

Remove Labels

short-input

Placeholder: Comma-separated label IDs (e.g., UNREAD, INBOX)

Layout: full

Condition: operation = "modify_labels_gmail"

Inputs (API)

operation

string

Optional

credential

string

Required

to

string

Optional

subject

string

Optional

body

string

Optional

folder

string

Optional

messageId

string

Optional

unreadOnly

boolean

Optional

maxResults

number

Optional

query

string

Optional

searchMaxResults

number

Optional

replyMessageId

string

Optional

replyBody

string

Optional

replyAll

boolean

Optional

forwardMessageId

string

Optional

forwardTo

string

Optional

forwardBody

string

Optional

trashMessageId

string

Optional

untrash

boolean

Optional

modifyMessageId

string

Optional

addLabelIds

string

Optional

removeLabelIds

string

Optional

Outputs

Primary response type:

{
  "content": "string",
  "metadata": "json"
}

Tool Access

gmail_sendgmail_readgmail_searchgmail_replygmail_forwardgmail_trashgmail_list_labelsgmail_modify_labels