Manage Gmail Label
manage_gmail_labelDestructive
Create, update, or delete Gmail labels for one or multiple users. Supports single and batch operations with color and visibility settings.
Instructions
Manage Gmail labels: create, update, or delete labels. Supports single or multiple label operations using lists or JSON strings.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Label name(s) - REQUIRED for CREATE. Single: 'My Label' or Multiple: ['Label1', 'Label2'] or JSON string | |
| action | Yes | Action to perform: 'create' (requires name), 'update' (requires label_id), 'delete' (requires label_id) | |
| label_id | No | Label ID(s) - REQUIRED for UPDATE/DELETE. Single: 'Label_123' or Multiple: ['Label_1', 'Label_2'] or JSON string | |
| text_color | No | Text color(s) - hex codes (e.g., '#ff0000'), color names (e.g., 'red'), auto-corrected to closest Gmail color. Single value, list, or dict mapping | |
| background_color | No | Background color(s) - hex codes (e.g., '#ffffff'), color names (e.g., 'white'), auto-corrected to closest Gmail color. Single value, list, or dict mapping | |
| user_google_email | No | Use 'me' or 'myself' for auto-resolution to authenticated user, or provide specific email address. If None, uses current authenticated user (auto-injected by middleware). | |
| label_list_visibility | No | Label visibility in Gmail sidebar: 'labelShow' or 'labelHide'. Can be single value or list for multiple labels | labelShow |
| message_list_visibility | No | Message visibility in conversations: 'show' or 'hide'. Can be single value or list for multiple labels | show |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Error message if operation failed | |
| action | Yes | Action performed: 'create', 'update', or 'delete' | |
| results | Yes | Status messages for each label operation (e.g., 'Created label: MyLabel (ID: Label_123)') | |
| success | Yes | Whether the operation completed successfully | |
| userEmail | Yes | Email of the authenticated user | |
| labels_processed | Yes | Number of labels that were processed in this operation | |
| color_adjustments | No | Color correction messages when requested colors were adjusted to nearest Gmail-supported colors |