Connector Center

Gmail

Manual setup, diagnostics, assets, freshness, and governance restrictions. Browser authorization buttons are intentionally not exposed in this workflow.

Connect Google Export Diagnostics JSON

Overview

Gmail

Draft creation / Thread logging / Reply sync later

Status

ready to connect

Connected Account

None

Auth Mode

oauth

Manual Setup

Credentials and source notes

Configure the Google OAuth app before Gmail authorization. Gmail draft creation uses the full mail scope and may require Google verification.

Provider docs

Account Label

Auth Mode

oauth

Copy Redirect URI

https://os.luzione.com/api/integrations/google/callback

Exact Scopes Requested

https://mail.google.com/

Decode Last Setup State

Provider setup checklist is complete.

Gmail draft creation should use https://mail.google.com/ and may require Google verification before broad production use.

Manual Token / API Key

Use this for personal access tokens, Admin API tokens, webhook secrets, and base IDs. Secret values are never shown again after save.

OAuth App Setup

Use this only for provider OAuth apps such as Google. If these values are in Vercel env vars, they are already durable.

App nameClient IDClient secretRedirect URIScopesSupport emailDeveloper contact emailAudienceAuthorized domainsHomepage URLPrivacy policy URLTerms of service URLTest users

Additional Setup Notes

Account email

Operator Notes

Setup Checklist

Confirm Google consent and Gmail API access requirements are understood.
If app is in Testing, add the operator account as a test user.
Enable Gmail API in the same Google Cloud project.
Record the operator mailbox and exact Gmail scopes.
Use https://mail.google.com/ only when draft creation/thread sync are actually required.

Assets

Choose Assets is disabled until the provider is connected and asset listing is supported.

Required Environment

Required environment is present.

Diagnostics

{
  "provider_key": "gmail",
  "status": "ready_to_connect",
  "required_env_present": true,
  "missing_env_vars": [],
  "provider_setup_complete": true,
  "missing_setup_fields": [],
  "missing_setup_labels": [],
  "setup_warnings": [
    "Gmail draft creation should use https://mail.google.com/ and may require Google verification before broad production use."
  ],
  "redirect_uri_expected": "https://os.luzione.com/api/integrations/google/callback",
  "callback_route": "/api/integrations/gmail/callback",
  "scopes": [
    "https://mail.google.com/"
  ],
  "token_present": false,
  "token_expiry": null,
  "last_test_status": null,
  "last_test_error": null,
  "decoded_last_error": null,
  "app_review_required": true,
  "setup_steps": [
    "Confirm Google consent and Gmail API access requirements are understood.",
    "If app is in Testing, add the operator account as a test user.",
    "Enable Gmail API in the same Google Cloud project.",
    "Record the operator mailbox and exact Gmail scopes.",
    "Use https://mail.google.com/ only when draft creation/thread sync are actually required."
  ],
  "assets_supported": false,
  "assets_selected": false,
  "governed_usage_allowed": true,
  "external_actions_enabled": false
}