manage_people_contact_labels
Add or remove contacts from a Google contact label. Provide the action ('label_add' or 'label_remove'), emails, and label name to manage group membership.
Instructions
Manage Google People contact labels (contact groups) for one or more emails. Supports 'label_add' to ensure contacts exist and attach them to a label, and 'label_remove' to detach matching contacts from a label.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | |||
| label | No | ||
| action | Yes | ||
| 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). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Error message if operation failed | |
| action | Yes | Action that was performed: 'label_add' or 'label_remove' | |
| message | No | Human-readable summary of the operation result | |
| success | Yes | Whether the operation completed successfully | |
| label_name | Yes | Name of the contact group/label that was managed | |
| batch_errors | No | Number of batch API operations that encountered errors | |
| failed_emails | No | List of email addresses that failed to process | |
| contacts_created | No | Number of new contacts that were created (for label_add action) | |
| emails_processed | No | Total number of email addresses that were processed | |
| contacts_existing | No | Number of existing contacts found (for label_add action) | |
| contacts_modified | No | Number of contacts that were added to or removed from the label | |
| contacts_not_found | No | Number of emails with no matching contacts (for label_remove action) | |
| label_resourceName | No | Resource name/ID of the contact group |