> ## Documentation Index
> Fetch the complete documentation index at: https://developers.myhero.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Gmail modify labels

> Add or remove Gmail labels on a message. Use the system label ids INBOX, UNREAD, STARRED, TRASH, or a custom label id. Removing UNREAD marks a message…

`gmail_modify_labels`

Add or remove Gmail labels on a message. Use the system label ids `INBOX`, `UNREAD`, `STARRED`, `TRASH`, or a custom label id. Removing `UNREAD` marks a message read; removing `INBOX` archives it.

## Parameters

<ParamField path="id" type="string" required>
  Gmail message id (from gmail\_search).
</ParamField>

<ParamField path="addLabelIds" type="array<string>">
  Label ids to add.
</ParamField>

<ParamField path="removeLabelIds" type="array<string>">
  Label ids to remove.
</ParamField>