Gmail
Communication User OAuth

Gmail

Access and manage Gmail messages, labels, and settings through Google's OAuth 2.0 integration.

Auth Model

User OAuth

Standard OAuth 2.0 authorization. A user grants consent and receives an access token. Authpipe handles refresh, rotation, and health monitoring automatically.

Connection Flow

1
Your App
2
Authpipe
3
Gmail
@authpipe/node
// Get a valid credential — always fresh, zero latency
const { credential } = await authpipe.getCredential({
  provider: 'gmail',
  tenantId: 'org_acme',
  userId: 'user_123',
});
// Use the credential with the provider API
const response = await fetch('https://api.example.com/data', {
  headers: { Authorization: `Bearer ${credential}` },
});
@authpipe/react
// Drop-in React component
<ConnectButton
  provider="gmail"
  onSuccess={(conn) => console.log('Connected!', conn)}
/>

Available Scopes

Permissions you can request when connecting to Gmail.

https://www.googleapis.com/auth/gmail.readonly

Read-only access to Gmail messages and settings

https://www.googleapis.com/auth/gmail.send

Send email on behalf of the user

https://www.googleapis.com/auth/gmail.modify

Read, send, delete, and manage email and drafts

https://www.googleapis.com/auth/gmail.compose

Create, read, update, and delete drafts and send messages

https://www.googleapis.com/auth/gmail.labels

Create, read, update, and delete labels

What Authpipe handles for Gmail

OAuth Orchestration

PKCE, state validation, callback handling, and provider-specific quirks — all automatic.

Encrypted Vault

AES-256-GCM encryption with per-tenant key isolation. OAuth tokens, API keys, and webhook secrets — never exposed to the frontend.

Silent Refresh

Proactive token refresh before expiry. SDK returns from local cache with zero latency.

Health Monitoring

Scheduled checks detect revoked tokens and expired credentials before users notice.

More Communication providers

Ready to connect Gmail?

Get your first 100 connections free. Set up in minutes with our SDK.