Unitalk GmailInstall

Summary

Retrieve multiple Gmail messages with optional filters, pagination, and data simplification.

Inputs

• returnAll — Whether to return all results or up to the given limit. Default: false. Shown for operation: getAll, resource: message.
• limit — Maximum number of messages to return. Range: 1‑500. Default: 10. Shown when returnAll is false for operation: getAll, resource: message.
• simple — Whether to return a simplified response with headers extracted and label IDs replaced by names, instead of raw data. Default: true. Shown for operation: getAll, resource: message.
• filters — Filter messages by spam/trash inclusion, labels, search query, read status, and date ranges. Shown for operation: getAll, resource: message. Options: includeSpamTrash (boolean), labelIds (multiOptions), q (string, Gmail search format), readStatus (options: both/unread/read), receivedAfter (dateTime), receivedBefore (dateTime), sender (string).
• options — Attachment and download configuration. Shown when simple is false. Options: dataPropertyAttachmentsPrefixName (string, default: 'attachment_'), downloadAttachments (boolean, default: false).

Output shape

Array of message objects. When simple is true: payload.headers flattened to top‑level properties (From, To, Cc, Bcc, Subject) and labelIds resolved to a labels array of {id, name} objects. When simple is false: fully parsed message objects; if downloadAttachments is true, attachments are decoded and included as binary data properties named with the prefix and index; otherwise raw message data is returned with attachments referenced but not decoded.

Filters parameter 'q' is combined with sender, readStatus, receivedAfter, and receivedBefore into a Gmail API query string via prepareQuery. Pagination is handled internally when returnAll is true using googleApiRequestAllItems with maxResults=100 and page‑token looping. The node requires a connected Gmail account (unitalkGmailApi credentials).

Links

• n8n community nodes installation guide