Gmail

Monitor your inbox for urgent emails, emails needing reply, and messages from specific people. Phyllax uses a two-pass AI triage — first classifies emails (person, transactional, marketing), then checks urgency on the important ones.

Quick Setup

Option A: API Key (Simpler)

1. Go to Google Cloud Console
2. Create a new project (or select existing)
3. Go to APIs & Services → Library → search "Gmail API" → Enable
4. Go to APIs & Services → Credentials → Create Credentials → API Key
5. Copy the API key
6. In Phyllax → Integrations → Gmail → Connect → paste the key

Option B: OAuth (Full access — recommended)

1. Go to Google Cloud Console
2. Create a new project
3. Go to APIs & Services → Library → enable Gmail API
4. Go to APIs & Services → OAuth consent screen → configure (External, add your email as test user)
5. Go to Credentials → Create Credentials → OAuth Client ID → Desktop app
6. Copy the Client ID and Client Secret
7. In Phyllax → Settings → Google OAuth → paste Client ID and Client Secret → click Authorize with Google
8. Complete the sign-in flow in the browser
9. Gmail will show as connected automatically

Which method?

API Key is faster to set up but has limited access. OAuth gives full access including sending emails and managing labels — required for features like "Mark as read" and "Reply".

What Phyllax Monitors

Schedule	What it checks
Urgent emails	Emails marked high priority or containing urgent language
Emails needing reply	Emails from real people waiting for your response (older than 24h)
Email from person	Emails from a specific sender (parameterized — you enter the name)
Daily inbox summary	Overview of today's emails — what needs attention, what can wait
Unread digest	Summary of all unread emails grouped by importance

How Two-Pass Triage Works

Phyllax doesn't dump your entire inbox to the AI. Instead:

1. Fetch — pulls your last 15 emails (configurable: 5-50)
2. Pass 1 — Classify — AI categorizes each as PERSON / TRANSACTIONAL / MARKETING / AUTOMATED
3. Filter — marketing and automated emails are dropped (unless you enable them in settings)
4. Pass 2 — Urgency — AI checks only the survivors for actual urgency

This means the AI never wastes tokens on newsletters and shipping updates.

Notification Actions

Each email gets its own notification card with the sender name, subject, and email body preview. When you expand a card:

• AI Suggested Replies — auto-generated reply drafts in different tones (Professional, Friendly, Confirming, Defer). Click a tone, edit if needed, then send.
• Send — sends the reply directly via Gmail API as you (not as a bot). Replies land in the same email thread.
• Open in Gmail — open the email in your browser
• Mark as read — marks via Gmail API
• Mute sender — never get notified about this sender again
• Delete — moves to trash
• Snooze — hide for 1 hour

Settings

In the integration manage modal:

• Unread only — only scan unread emails (skip already-read ones)
• Max emails — how many to scan per check (5-50, default 15)
• Marketing notifications — enable/disable alerts for promotional emails
• Shipping notifications — enable/disable alerts for shipping updates
• Muted senders — list of senders you've muted (can unmute here)
• Auto mark muted as read — automatically mark muted sender emails as read

Troubleshooting

"Invalid credentials" or "OAuth token expired" error

Your API key or OAuth token may be expired. For OAuth: disconnect Gmail → click Authorize with Google again → complete sign-in. This gets a fresh token. For API key, generate a new one in Google Cloud Console.

Not seeing all emails

Check the Max emails setting — default is 15. Increase to 50 if you have a high-volume inbox. Also check if Unread only is enabled — it skips read emails.

Marketing emails showing up

Go to the integration manage modal and disable Marketing notifications. You can also mute specific senders.

"Mark as read" not working

This requires OAuth (not just API key). Set up OAuth via Settings → Google OAuth to enable write operations.