How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Google Gmail

Google Gmail Gmail API

The Gmail API from Google Gmail — 19 operation(s) for gmail.

Documentation Provider Profile APIs.io OpenAPI GitHub

Google Gmail Gmail API is published by Google Gmail on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Gmail. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, a getting-started guide, a JSON-LD context, and 1 JSON Schema.

This API exposes 29 operations across 19 paths, and defines 13 schemas. It is described by OpenAPI 3.1.0, at version v1.

Requests are made against a single base URL, https://gmail.googleapis.com.

29 operations 19 paths 13 schemas 4 DELETE12 GET11 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v1
Base URL
https://gmail.googleapis.com
Contact
Google
Resource Areas
1

Paths & Operations 29

Across 19 paths, the API surfaces 29 operations — 4 DELETE, 12 GET, 11 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Gmail 29
GET
/gmail/v1/users/{userId}/profile
Google Gmail Get user profile
getUserProfile 1 param → 200
GET
/gmail/v1/users/{userId}/messages
Google Gmail List messages
listMessages 5 params → 200
POST
/gmail/v1/users/{userId}/messages
Google Gmail Insert message
insertMessage 1 param body → 200
GET
/gmail/v1/users/{userId}/messages/{id}
Google Gmail Get message
getMessage 3 params → 200
DELETE
/gmail/v1/users/{userId}/messages/{id}
Google Gmail Delete message
deleteMessage 2 params → 204
POST
/gmail/v1/users/{userId}/messages/send
Google Gmail Send message
sendMessage 1 param body → 200
POST
/gmail/v1/users/{userId}/messages/{id}/modify
Google Gmail Modify message
modifyMessage 2 params body → 200
POST
/gmail/v1/users/{userId}/messages/{id}/trash
Google Gmail Trash message
trashMessage 2 params → 200
POST
/gmail/v1/users/{userId}/messages/{id}/untrash
Google Gmail Untrash message
untrashMessage 2 params → 200
GET
/gmail/v1/users/{userId}/labels
Google Gmail List labels
listLabels 1 param → 200
POST
/gmail/v1/users/{userId}/labels
Google Gmail Create label
createLabel 1 param body → 200
GET
/gmail/v1/users/{userId}/labels/{id}
Google Gmail Get label
getLabel 2 params → 200
PUT
/gmail/v1/users/{userId}/labels/{id}
Google Gmail Update label
updateLabel 2 params body → 200
DELETE
/gmail/v1/users/{userId}/labels/{id}
Google Gmail Delete label
deleteLabel 2 params → 204
GET
/gmail/v1/users/{userId}/threads
Google Gmail List threads
listThreads 4 params → 200
GET
/gmail/v1/users/{userId}/threads/{id}
Google Gmail Get thread
getThread 2 params → 200
DELETE
/gmail/v1/users/{userId}/threads/{id}
Google Gmail Delete thread
deleteThread 2 params → 204
GET
/gmail/v1/users/{userId}/drafts
Google Gmail List drafts
listDrafts 1 param → 200
POST
/gmail/v1/users/{userId}/drafts
Google Gmail Create draft
createDraft 1 param body → 200
GET
/gmail/v1/users/{userId}/drafts/{id}
Google Gmail Get draft
getDraft 2 params → 200
PUT
/gmail/v1/users/{userId}/drafts/{id}
Google Gmail Update draft
updateDraft 2 params body → 200
DELETE
/gmail/v1/users/{userId}/drafts/{id}
Google Gmail Delete draft
deleteDraft 2 params → 204
POST
/gmail/v1/users/{userId}/drafts/send
Google Gmail Send draft
sendDraft 1 param body → 200
GET
/gmail/v1/users/{userId}/history
Google Gmail List history
listHistory 2 params → 200
POST
/gmail/v1/users/{userId}/watch
Google Gmail Watch mailbox
watchMailbox 1 param body → 200
POST
/gmail/v1/users/{userId}/stop
Google Gmail Stop watching mailbox
stopMailboxWatch 1 param → 204
GET
/gmail/v1/users/{userId}/settings/autoForwarding
Google Gmail Get auto-forwarding settings
getAutoForwarding 1 param → 200
GET
/gmail/v1/users/{userId}/settings/filters
Google Gmail List filters
listFilters 1 param → 200
POST
/gmail/v1/users/{userId}/settings/filters
Google Gmail Create filter
createFilter 1 param → 200

Schemas 13

The contract defines 13 schemas that model the data the API accepts and returns. The most detailed are Message (8 properties), Label (5 properties), Profile (4 properties), Thread (4 properties). Each schema is shown below with its type and property counts.

Message
object
8 properties
ModifyMessageRequest
object
2 properties
ListMessagesResponse
object
3 properties
WatchRequest
object
3 properties
Label
object
5 properties
Thread
object
4 properties
ListHistoryResponse
object
3 properties
ListDraftsResponse
object
3 properties
ListLabelsResponse
object
1 property
Draft
object
2 properties
Profile
object
4 properties
ListThreadsResponse
object
3 properties
WatchResponse
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

google-gmail-gmail-api-openapi.yml Raw ↑
#Gmail
← Back to G APIs
API Details
ID
google-gmail:google-gmail-gmail-api
Base URL
https://gmail.googleapis.com
Docs
https://developers.google.com/workspace/gmail/api/guides
Provider
Google Gmail
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=google-gmail-gmail-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/google-gmail-gmail-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Google Gmail Gmail API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.