Skip to main content
Version: 3.2.0

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 client
  • src/protocol/source/email/email.service.ts - poll, download, init per mailbox
  • src/config.dto.ts / src/core/configuration/config.schema.ts - provider, auth, mailbox list
  • ui/src/pages/workflows/stepForms/StepInitForm.tsx - Workspace connection step
  • ui/src/pages/workflows/stepForms/StepEmailForm.tsx - mailbox/label chips
  • ui/src/protocol/tower.mock.ts - demo Workspace source
  • docs/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.