GMail integration

List Inbox Messages

Perform List Inbox Messages through GMail.

View as Markdown

gmail_list_inbox_messages

read

Inputs

search_phrase
text
Search Phrase
Optional text value.
since_days
number
Since Days
Optional numeric value.
max_results
number
Max Results
Optional numeric value.
Default: 25
with_labels
text
With Labels
Optional text value.
without_labels
text
Without Labels
Optional text value.
untagged_only
boolean
Untagged Only
Optional true-or-false value.
Default: false
unread_only
boolean
Unread Only
Optional true-or-false value.
Default: false

Outputs

successSuccess
messagesMessages
message_idsMessage Ids
countCount
scannedScanned
scan_limit_hitScan Limit Hit
unknown_labelsUnknown Labels
errorError
error_messageError Message
error_codeError Code

Output schema completeness: best_effort_declared

Safety

External effect: read
Confirmation recommended: No
Retry safe: Yes
Dry run supported: No

Schemas

These schemas are first-pass authoring guidance. Runtime validation remains authoritative.

Input schema

{
  "type": "object",
  "properties": {
    "since_days": {
      "type": "number",
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "max_results": {
      "type": "number",
      "default": 25,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "unread_only": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "with_labels": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "search_phrase": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "untagged_only": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "without_labels": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    }
  },
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "count": {},
    "error": {},
    "scanned": {},
    "success": {},
    "messages": {},
    "error_code": {},
    "message_ids": {},
    "error_message": {},
    "scan_limit_hit": {},
    "unknown_labels": {}
  },
  "additionalProperties": true
}

View all GMail actions