Gmail API

Deep Gmail Integration

Connect your Gmail account via OAuth 2.0 with offline access. Import messages, manage labels, and configure Send Mail As — all through the official Gmail API.

Capabilities

What You Can Do With Gmail

Clacks uses the google/apiclient library with 6 OAuth scopes to provide comprehensive Gmail access.

Message Import

Emails fetched from POP3 or IMAP are imported into Gmail using the users.messages.import API endpoint. Messages appear in your inbox with original headers preserved.

Label Management

Create, list, and assign Gmail labels directly through the API. Each bridge route can apply labels automatically via the Gmail API modify() method.

Send Mail As

Configure Gmail to send emails from your external addresses. Full CRUD support for Send Mail As aliases — add, verify, update, and remove sender identities.

Send Mail As

Reply From Any Address

Configure Gmail to send and reply as your external email addresses. Recipients see your custom domain, not your Gmail address.

Add Sender Identity

Register an external email address as a Send Mail As alias in Gmail. Clacks handles the API call and verification flow for you.

Verification Management

Track verification status for each alias. Resend verification emails or check completion — all from your Clacks dashboard.

Update & Remove

Full CRUD control over Send Mail As aliases. Update display names, change SMTP settings, or remove aliases you no longer need.

Custom Domain Replies

When someone replies to an imported email, Gmail sends the response from your custom domain address — keeping your brand consistent.

Authentication

How OAuth 2.0 Works

Secure, standard OAuth flow — we never see your Gmail password.

1

Authorize With Google

Click "Connect Gmail" and sign in with your Google account. You review and approve the specific permissions Clacks requests.

2

Receive OAuth Token

Google issues an OAuth 2.0 token with offline access. This token is encrypted and stored using our envelope encryption system.

3

API Access Enabled

Clacks uses the token to interact with the Gmail API — importing messages, managing labels, and configuring Send Mail As aliases.

FAQ

Common Questions

Does Clacks store my Gmail password?

No. Clacks uses OAuth 2.0 with offline access. You authenticate directly with Google, and Clacks receives a token — never your password. The token is encrypted with XChaCha20-Poly1305 before storage.

What OAuth scopes does Clacks request?

Clacks requests 6 specific Gmail API scopes covering message import, label management, Send Mail As configuration, and basic profile access. Only the minimum permissions needed are requested.

Can I revoke access?

Yes. You can revoke Clacks' access at any time from your Google Account security settings or by disconnecting your Gmail account from the Clacks dashboard.

Ready to get started?

Bridge your email accounts to Gmail in minutes. Free plan available, no credit card required.

Explore

Related Features