Gmail Get Sent

Controlled node

Overview

The Gmail Get Sent node fetches messages from the Sent folder of a connected Gmail account. When the Run event fires, the node retrieves sent messages for the selected connection and outputs them as a list, displaying the results in the node's panel UI.

This is a controlled node, meaning it only executes when its Run event is triggered by another node, and it fires a Done event when it has finished.

Fetch limits

There is a hard maximum of 500 messages per fetch. By default the node fetches the 100 most recent sent messages. You can page through your sent mail using the Limit, Offset, and Page Token inputs.

Selecting a connection

The Connections input is configured from the node's panel UI rather than on the node itself. Select a Gmail connection for your project before running the node, otherwise the node will return an error.

Inputs

Input	Type	Description	Default
Run	Event	Triggers the node to fetch sent messages.	-
Connections	Connection	The Gmail connection to fetch sent messages from. Configured in the panel UI.	-
Limit	Number	The maximum number of messages to fetch. Must be a positive integer no greater than 500.	100
Offset	Number	The number of messages to skip before returning results. Must be a non-negative integer.	0
Page Token	Text	An optional Gmail page token supported by the backend. The current editor class does not expose this socket.	-

Outputs

Output	Type	Description
Messages	Data	The list of fetched sent messages. If the fetch fails, this contains an object with an error field describing the problem.
Done	Event	Fires when the node has finished running.

Runtime behavior

• The node requires an active project and a selected Gmail connection. If either is missing, the Messages output will contain an error such as Select a connection first.
• Limit and Offset are validated before fetching. If the limit is not a positive integer, exceeds 500, or the offset is negative, the Messages output will contain an error describing the validation failure.
• If a Page Token is provided it must be a string, otherwise an error is returned.
• If the Gmail request itself fails, the Messages output will contain { error: "Failed to fetch sent messages" }.
• The Done event fires after the fetch completes, making it useful for chaining follow-up nodes.

Example

Fetch the 50 most recent sent emails and display them:

1. Add a Gmail Get Sent node to your workflow.
2. Open the node's panel and select your Gmail connection under Connections.
3. Set Limit to 50 and leave Offset at 0.
4. Connect a trigger (such as a Button node or workflow start event) to the node's Run input.
5. Connect the Messages output to a display or processing node (for example, a Table node or a Loop node to process each message).
6. Use the Done event to trigger any downstream steps that should run after the messages have been fetched.

To page through older sent mail in the editor, run the node again with Offset increased by the limit (e.g. 50, 100, 150).