Gmail API email source
Overview
A Workspace tenant with IMAP disabled can still deposit scans by email. Tower reads one mailbox through the Gmail API, same hourly poll and Check now as IMAP.
How it works
Email sources accept provider: gmail with a JSON key or Workload Identity. Tower impersonates the Workspace user (url) using domain-wide delegation (gmail.readonly). The cursor is Gmail historyId. Several labels or IMAP folders are configured on the filters step; senders and extensions stay global for the source.
Key files
src/protocol/source/email/gmail.client.ts- JWT / Workload Identity Gmail clientsrc/protocol/source/email/email.service.ts- poll, download, init per mailboxsrc/config.dto.ts/src/core/configuration/config.schema.ts-provider,auth, mailbox listui/src/pages/workflows/stepForms/StepInitForm.tsx- Workspace connection stepui/src/pages/workflows/stepForms/StepEmailForm.tsx- mailbox/label chipsui/src/protocol/tower.mock.ts- demo Workspace sourcedocs/user/configuration/gmail-workspace.md- prepare Workspace (EN / FR)docs/user/configuration/sources.md/examples.md- Gmail YAML (EN / FR)test/setup/seed-gitea.sh- Gitea seed uses the compose project container name
Known issues
- None recorded in the 3.2.0 fragment.
Next steps
- None from this release.