Google Gmail · OAuth Scopes

Google Gmail OAuth Scopes

OAuth 2.0 derived

Google Gmail publishes 30 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Google Gmail API on a user’s behalf.

Tokens are issued from https://oauth2.googleapis.com/token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

DraftsEmailGmailGoogleGoogle WorkspaceLabelsMessagingThreads

Scopes: 30 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://accounts.google.com/o/oauth2/auth

Token URL
https://oauth2.googleapis.com/token

Flows
authorizationCode

Scopes (30)

Scope	Description	Flows
https://mail.google.com/	Read, compose, send, and permanently delete all your email from Gmail	authorizationCode
https://www.googleapis.com/auth/gmail.addons.current.action.compose	Manage drafts and send emails when you interact with the add-on	authorizationCode
https://www.googleapis.com/auth/gmail.addons.current.message.action	View your email messages when you interact with the add-on	authorizationCode
https://www.googleapis.com/auth/gmail.addons.current.message.metadata	View your email message metadata when the add-on is running	authorizationCode
https://www.googleapis.com/auth/gmail.addons.current.message.readonly	View your email messages when the add-on is running	authorizationCode
https://www.googleapis.com/auth/gmail.compose	Manage drafts and send emails	authorizationCode
https://www.googleapis.com/auth/gmail.drafts	Read, compose, send, update, and permanently delete your draft emails	authorizationCode
https://www.googleapis.com/auth/gmail.drafts.create	Compose new draft emails	authorizationCode
https://www.googleapis.com/auth/gmail.drafts.readonly	Read your draft emails	authorizationCode
https://www.googleapis.com/auth/gmail.insert	Add emails into your Gmail mailbox	authorizationCode
https://www.googleapis.com/auth/gmail.labels	See and edit your email labels	authorizationCode
https://www.googleapis.com/auth/gmail.labels.create	Create new email labels	authorizationCode
https://www.googleapis.com/auth/gmail.labels.readonly	Read your email labels	authorizationCode
https://www.googleapis.com/auth/gmail.messages	Read, update, and permanently delete all your emails	authorizationCode
https://www.googleapis.com/auth/gmail.messages.delete	Permanently delete all your emails	authorizationCode
https://www.googleapis.com/auth/gmail.messages.modify	Update but not delete your emails	authorizationCode
https://www.googleapis.com/auth/gmail.messages.readonly	Read your emails	authorizationCode
https://www.googleapis.com/auth/gmail.metadata	View your email message metadata such as labels and headers, but not the email body	authorizationCode
https://www.googleapis.com/auth/gmail.modify	Read, compose, and send emails from your Gmail account	authorizationCode
https://www.googleapis.com/auth/gmail.readonly	View your email messages and settings	authorizationCode
https://www.googleapis.com/auth/gmail.send	Send email on your behalf	authorizationCode
https://www.googleapis.com/auth/gmail.send.self	Send email to yourself	authorizationCode
https://www.googleapis.com/auth/gmail.settings.basic	See, edit, create, or change your email settings and filters in Gmail	authorizationCode
https://www.googleapis.com/auth/gmail.settings.filters	Read, create, and delete your filters	authorizationCode
https://www.googleapis.com/auth/gmail.settings.filters.readonly	Read your filters	authorizationCode
https://www.googleapis.com/auth/gmail.settings.sharing	Manage your sensitive mail settings, including who can manage your mail	authorizationCode
https://www.googleapis.com/auth/postmaster	Get email traffic metrics, manage domains, and manage domain users for the domains you have registered with Postmaster Tools	authorizationCode
https://www.googleapis.com/auth/postmaster.domain	View and manage the domains you have registered with Postmaster Tools	authorizationCode
https://www.googleapis.com/auth/postmaster.traffic.readonly	Get email traffic metrics for the domains you have registered with Postmaster Tools	authorizationCode
https://www.googleapis.com/auth/postmaster.user	View and manage users for the domains you have registered with Postmaster Tools	authorizationCode

📄 Provider scope reference:

Source

OAuth Scopes

generated: '2026-11-11'
method: derived
source: openapi/google-gmail-gmail-users-api-openapi.yml, openapi/google-gmail-gmailpostmastertools-domain-stats-api-openapi.yml,
  openapi/google-gmail-gmailpostmastertools-domains-api-openapi.yml
schemes:
- name: oauth2
  source: openapi/google-gmail-gmail-users-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://accounts.google.com/o/oauth2/auth
    tokenUrl: https://oauth2.googleapis.com/token
- name: oauth2
  source: openapi/google-gmail-gmailpostmastertools-domain-stats-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://accounts.google.com/o/oauth2/auth
    tokenUrl: https://oauth2.googleapis.com/token
- name: oauth2
  source: openapi/google-gmail-gmailpostmastertools-domains-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://accounts.google.com/o/oauth2/auth
    tokenUrl: https://oauth2.googleapis.com/token
scopes:
- scope: https://mail.google.com/
  description: Read, compose, send, and permanently delete all your email from Gmail
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.addons.current.action.compose
  description: Manage drafts and send emails when you interact with the add-on
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.addons.current.message.action
  description: View your email messages when you interact with the add-on
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.addons.current.message.metadata
  description: View your email message metadata when the add-on is running
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.addons.current.message.readonly
  description: View your email messages when the add-on is running
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.compose
  description: Manage drafts and send emails
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.drafts
  description: Read, compose, send, update, and permanently delete your draft emails
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.drafts.create
  description: Compose new draft emails
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.drafts.readonly
  description: Read your draft emails
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.insert
  description: Add emails into your Gmail mailbox
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.labels
  description: See and edit your email labels
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.labels.create
  description: Create new email labels
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.labels.readonly
  description: Read your email labels
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.messages
  description: Read, update, and permanently delete all your emails
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.messages.delete
  description: Permanently delete all your emails
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.messages.modify
  description: Update but not delete your emails
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.messages.readonly
  description: Read your emails
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.metadata
  description: View your email message metadata such as labels and headers, but not the email
    body
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.modify
  description: Read, compose, and send emails from your Gmail account
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.readonly
  description: View your email messages and settings
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.send
  description: Send email on your behalf
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.send.self
  description: Send email to yourself
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.settings.basic
  description: See, edit, create, or change your email settings and filters in Gmail
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.settings.filters
  description: Read, create, and delete your filters
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.settings.filters.readonly
  description: Read your filters
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/gmail.settings.sharing
  description: Manage your sensitive mail settings, including who can manage your mail
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmail-users-api-openapi.yml
- scope: https://www.googleapis.com/auth/postmaster
  description: Get email traffic metrics, manage domains, and manage domain users for the domains
    you have registered with Postmaster Tools
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmailpostmastertools-domain-stats-api-openapi.yml
  - openapi/google-gmail-gmailpostmastertools-domains-api-openapi.yml
- scope: https://www.googleapis.com/auth/postmaster.domain
  description: View and manage the domains you have registered with Postmaster Tools
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmailpostmastertools-domain-stats-api-openapi.yml
  - openapi/google-gmail-gmailpostmastertools-domains-api-openapi.yml
- scope: https://www.googleapis.com/auth/postmaster.traffic.readonly
  description: Get email traffic metrics for the domains you have registered with Postmaster
    Tools
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmailpostmastertools-domain-stats-api-openapi.yml
  - openapi/google-gmail-gmailpostmastertools-domains-api-openapi.yml
- scope: https://www.googleapis.com/auth/postmaster.user
  description: View and manage users for the domains you have registered with Postmaster Tools
  flows:
  - authorizationCode
  sources:
  - openapi/google-gmail-gmailpostmastertools-domain-stats-api-openapi.yml
  - openapi/google-gmail-gmailpostmastertools-domains-api-openapi.yml

Work with this as data

Every scope set here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for oauth scopes

4 MCP tools reach this

find_scopesBrowse and filter every scope set in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This scope set

curl "https://apis.io/api/v1/scopes/google-gmail-scopes"

All oauth scopes

curl "https://apis.io/api/v1/scopes?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.