Update Gmail Labels

The Update Gmail Labels block modifies the labels applied to Gmail messages, either adding or removing them based on your input. You can target messages in two ways: by providing a Gmail search query (using standard Gmail search syntax) or by supplying a comma-separated list of explicit message IDs. This makes the block flexible for both dynamic, condition-based label updates and precise single-message operations.

The block accepts four main parameters beyond the Google OAuth connection: a query string, a messageIds string, an addLabelIds string, and a removeLabelIds string. Both the add and remove fields accept comma-separated label names or Gmail label IDs, and label names are resolved automatically. You can use either or both of the add and remove fields in a single operation.

This block fits into workflows that involve organizing, triaging, or routing email — for example, automatically labeling incoming messages based on content analysis, marking processed emails after an action has been taken, or removing labels as part of a multi-step email management pipeline. The block returns an array of Gmail message IDs that were successfully updated, which can be passed to downstream blocks for further processing.