Create Gmail Filter

Execute Google Workspace workflow: $ARGUMENTS

Create a Gmail Filter

PREREQUISITE: Load the following skills to execute this recipe: gws-gmail

Create a Gmail filter to automatically label, star, or categorize incoming messages.

Steps

1. List existing labels: gws gmail users labels list --params '{"userId": "me"}' --format table
2. Create a new label: gws gmail users labels create --params '{"userId": "me"}' --json '{"name": "Receipts"}'
3. Create a filter: gws gmail users settings filters create --params '{"userId": "me"}' --json '{"criteria": {"from": "receipts@example.com"}, "action": {"addLabelIds": ["LABEL_ID"], "removeLabelIds": ["INBOX"]}}'
4. Verify filter: gws gmail users settings filters list --params '{"userId": "me"}' --format table

Task

Execute this workflow with the following parameters: $ARGUMENTS

1. Prerequisites Check

   • Verify gws CLI is installed: gws --version
   • Confirm authentication: gws auth status
   • Load required GWS skills (check PREREQUISITE section above)

2. Parameter Preparation

   • Parse task parameters from $ARGUMENTS
   • Validate required inputs
   • Prepare JSON payloads and flags

3. Execute Workflow Steps

   • Follow the steps outlined above
   • Replace placeholder IDs with actual values
   • Handle errors and retries
   • Log progress and results

4. Verify Results

   • Confirm each step completed successfully
   • Verify changes in Google Workspace
   • Report final status and any issues

Tips

• Use --dry-run flag when available to preview changes
• Always inspect API schemas before calling: gws schema <service>.<resource>.<method>
• Check command help for all flags: gws <service> <resource> <method> --help

---

License: Apache License 2.0 Source: Google Workspace CLI Original Skill: recipe-create-gmail-filter