Skip to main content

Google Auth And Gmail Connect

This page explains Google sign-in and Gmail/Calendar connection in simple terms.

Two separate flows​

  1. Login flow: user signs into Nova with Google.
  2. Integration flow: user grants Gmail/Calendar access for assistant features.

What happens during connect​

  • dashboard starts OAuth
  • callback stores connection credentials safely
  • reconnect updates existing connection instead of creating accidental duplicates

Common issue​

redirect_uri_mismatch means the callback URL in Google Console does not exactly match the app callback URL.

Use Google Auth Setup Reference for exact setup steps.

Realtime Gmail ingest​

Nova can ingest Gmail updates using Pub/Sub push to:

  • POST /v1/ingress/gmail

Required verification env vars:

  • GOOGLE_PUSH_AUDIENCE
  • GOOGLE_PUSH_SERVICE_ACCOUNT
  • GOOGLE_GMAIL_WATCH_TOPIC_NAME