GMail integration

List Inbox Messages

Perform List Inbox Messages through GMail.

gmail_list_inbox_messages

read

Use in a workflow

Copy the discovered node config and fill its params from the input contract. Validate the complete graph before publishing. Integration results use {{node_id.default.field}}. Check business success before dependent writes; completion alone does not prove success.

{
  "_group": "GMail",
  "params": {
    "max_results": 25,
    "unread_only": false,
    "oldest_first": false,
    "untagged_only": false
  },
  "handler": "gmail_list_inbox_messages"
}

Action contracts and connections · Run recovery

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.
priority_labels
text
Priority Labels
Optional text value.
oldest_first
boolean
Oldest First
Optional true-or-false value.
Default: false
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
priority_message_idsPriority Message 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"
    },
    "oldest_first": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "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"
    },
    "priority_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": {},
    "priority_message_ids": {}
  },
  "additionalProperties": true
}

View all GMail actions