Actions26
Message → Add Label
AI-generatedSummary
Adds labels to a Gmail message.
Inputs
- messageId (required) — The ID of the Gmail message to which labels will be added.
- labelIds (required) — Label names or IDs to add to the message. Choose from the list or specify IDs using an expression.
Output shape
The Gmail API response for the message modify operation, returning the updated message metadata.
The operation sends a POST request to /gmail/v1/users/me/messages/{messageId}/modify with { addLabelIds: labelIds }.
Examples
Example 1: Add a label named 'Important' to a message.
Set messageId to the target message's ID, and set labelIds to ['Important'] or select 'Important' from the label picker.