To get the latest product updates delivered to you, add the URL of this page to your [feed reader](https://wikipedia.org/wiki/Comparison_of_feed_aggregators), or add the feed URL directly: `https://developers.google.com/feeds/gmail-release-notes.xml`. This page contains release notes for features and updates to the Gmail API. We recommend that Gmail API developers periodically check this list for any new announcements. ## November 10, 2026 Deprecated Versions `v1` and `v1beta1` of the Gmail Postmaster Tools API are deprecated and being turned down. We removed the v1 REST reference documentation and redirected all v1 reference URLs to the [Postmaster Tools API v2 REST reference](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2): - [`domains.trafficStats`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains.domainStats.md.txt) now redirects to the v2 `domains.domainStats` resource. - `domains.trafficStats.get` and `domains.trafficStats.list` now redirect to [`domains.domainStats.query`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains.domainStats/query.md.txt). If you still use the v1 API, migrate your application to v2. For step-by-step instructions, see [Migrate to Postmaster Tools API v2](https://developers.google.com/workspace/gmail/postmaster/guides/migration-v2). ## October 12, 2026 Announcement OAuth 2.0 clients calling the Gmail Model Context Protocol (MCP) server are required to have **Use this client for an AI-powered agent** selected in **Google Auth Platform** **\>** **Clients**. Starting November 11, 2026, Google Workspace MCP servers will reject requests from any app or integration whose OAuth client is not marked as agentic by selecting **Use this client for an AI-powered agent**. OAuth clients that are not marked as agentic by November 12, 2026 will remain non-agentic and can't call Google Workspace MCP servers. To use MCP after this date, you will need to create a new OAuth client marked as agentic and update your app to use it. Apps and integrations that are not AI agents, like those that only call Google Workspace REST APIs, are not affected by this change. If an existing OAuth client is used for both AI agent and non-agent features, create a separate OAuth client for the AI agent and mark only that client as agentic. Keep the existing client for your non-agent features. The Gmail MCP server is available as part of the [Developer Preview Program](https://developers.google.com/workspace/preview). For instructions on configuring an OAuth 2.0 client for the Gmail MCP server, see [Set up the Gmail MCP server](https://developers.google.com/workspace/gmail/api/guides/configure-mcp-server#configure-mcp-client) and [Manage OAuth Clients](https://support.google.com/cloud/answer/15549257). ## June 24, 2026 Feature **Generally Available** : The [Gmail Postmaster Tools API v2](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2) has new features for domain and user management. You can now create and manage [`domains`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains.md.txt) using these methods: - [`domains.create`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains/create.md.txt) - [`domains.delete`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains/delete.md.txt) - [`domains.verify`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains/verify.md.txt) - [`domains.getVerificationToken`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains/getVerificationToken.md.txt) Owners and admins can now also manage [domain users](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains.users) as well as update their permissions using these methods: - [`domains.users.create`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains.users/create.md.txt) - [`domains.users.delete`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains.users/delete.md.txt) - [`domains.users.get`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains.users/get.md.txt) - [`domains.users.list`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains.users/list.md.txt) - [`domains.users.patch`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains.users/patch.md.txt) Additionally, the [`domains.getComplianceStatus`](https://developers.google.com/workspace/gmail/postmaster/reference/rest/v2/domains/getComplianceStatus.md.txt) method now returns the deliverability status verdict. For more information, see the [Gmail Postmaster Tools API](https://developers.google.com/workspace/gmail/postmaster). ## May 13, 2026 Feature **[Developer Preview](https://developers.google.com/workspace/preview.md.txt):** We're extending the [Gmail Postmaster Tools v2 API](https://developers.google.com/workspace/gmail/postmaster.md.txt) with new features for domain and user management. This update includes the ability to programmatically add, verify, and remove domains. Owners and admins can also add and remove users from domains and update their permissions. Additionally, the `GetDomainComplianceStatus` API now returns the deliverability status verdict. To learn how to use these new features, see the [Postmaster Tools API](https://developers.google.com/workspace/gmail/postmaster.md.txt) documentation. ## May 01, 2026 Announcement **Generally Available**: Updates to Gmail API usage quotas A new tiering model with updates to API usage quotas will start to roll out. For more information, see [Google Workspace standardized model for agent tools and APIs](https://developers.google.com/workspace/tools-safety). Announcement **Generally Available** : Quota units for `drafts.get`, `messages.attachments.get`, `messages.get`, `messages.trash`, `threads.get`, and `threads.trash` have changed. ## April 22, 2026 Feature **[Developer Preview](https://developers.google.com/workspace/preview.md.txt)** : The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for Gmail is now available in developer preview. MCP is an open protocol that enables seamless integration between AI applications and Gmail. By configuring the Gmail MCP server, you enable AI agents to securely read your emails and take actions, such as creating drafts and labeling messages. For example, you can ask your AI agent: *"What did Ariel say in her last email about our marketing plan?"* To get started with the Gmail MCP server, see the following documentation: - [Set up the Gmail MCP server](https://developers.google.com/workspace/gmail/api/guides/configure-mcp-server.md.txt) - [Gmail MCP tool reference](https://developers.google.com/workspace/gmail/api/reference/mcp.md.txt) To find more available MCP servers, see [Model Context Protocol (MCP) servers in Google Workspace](https://developers.google.com/workspace/guides/configure-mcp-servers.md.txt). ## February 03, 2026 Feature **Generally Available** : The [Gmail Postmaster Tools API](https://developers.google.com/workspace/gmail/postmaster.md.txt) v2 is now generally available. The API provides access to the full Postmaster Tools dataset---including compliance status data---and includes enhancements like flexible querying with `queryDomainStats` and support for batch operations. For details on how to use the v2 API, see the updated [Postmaster Tools API documentation](https://developers.google.com/workspace/gmail/postmaster.md.txt). ## December 02, 2025 Feature **Developer Preview**: You can now access data in Gmail Postmaster Tools v2 using the v2beta API. The new API provides access to the full Postmaster Tools dataset, including compliance status data. The v2beta API also includes enhancements such as the `queryDomainStats` method for flexible querying, and adds support for batch operations. To learn how to use the API, see the [Postmaster Tools API documentation](https://developers.google.com/workspace/gmail/postmaster.md.txt). ## September 10, 2025 Feature You can now use annotations to create Deal Cards in the Promotions tab. To get started, see the [overview of Deal Cards](https://developers.google.com/workspace/gmail/promotab/overview.md.txt#deal-card). ## May 20, 2025 Feature For Google Workspace organizations that use hardware key encryption, the Gmail API supports using smart cards for client-side encryption (CSE). For details, see the reference documentation for [`CseIdentity`](https://developers.google.com/gmail/api/reference/rest/v1/users.settings.cse.identities) and [`CseKeyPair`](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.cse.keypairs.md.txt) resources. ## November 12, 2019 Change The `messages.import` method uses a more performant backend implementation. The new version is API-compatible with the previous implementation and all clients automatically started using the new behavior as of a few weeks ago. The new backend supports parallel `message.import` calls efficiently and clients can now import messages in parallel for a user to achieve higher migration throughput. The quota cost of the `message.import` method has been decreased to reflect the new performance. ## May 05, 2017 Deprecated Deprecated [Review Action](https://developers.google.com/gmail/markup/reference/review-action), which sunsets on July 15th, 2017. ## February 07, 2017 Feature The [`history.list` method](https://developers.google.com/gmail/api/v1/reference/users/history/list) supports filtering history records by type. ## November 30, 2016 Feature The [`messages.batchModify` method](https://developers.google.com/gmail/api/v1/reference/users/messages/batchModify) lets you modify labels on multiple messages by message IDs, in a single batch operation. ## November 01, 2016 Change The Gmail API supports a `gmail.metadata` scope. This scope gives developers access to a user's mailbox including history records, labels, and email headers, but not email body's or attachments. ## July 01, 2016 Change The `q` request parameter for the [`drafts.list` method](https://developers.google.com/gmail/api/v1/reference/users/drafts/list) restricts results to the messages matching the specified query. Feature New endpoints for managing mail settings: - [Send-as aliases and Signatures](https://developers.google.com/gmail/api/guides/alias_and_signature_settings) - [Forwarding](https://developers.google.com/gmail/api/guides/forwarding_settings) - [Filters](https://developers.google.com/gmail/api/guides/filter_settings) - [Vacation Responder](https://developers.google.com/gmail/api/guides/vacation_settings) - [POP and IMAP](https://developers.google.com/gmail/api/guides/pop_imap_settings) ## February 25, 2016 Feature The [`messages.batchDelete` method](https://developers.google.com/gmail/api/v1/reference/users/messages/batchDelete) lets you delete multiple messages, by message IDs, in a single batch operation. ## January 13, 2016 Feature The [`drafts.list` method](https://developers.google.com/gmail/api/v1/reference/users/drafts/list) has an `includeSpamTrash` option, which determines if the response should include drafts with the `SPAM` or `TRASH`label applied. The default is currently set to `true` for this option. ## June 22, 2015 Feature To determine the full state of an email before and after a change, the [`history.list` method](https://developers.google.com/gmail/api/v1/reference/users/history/list) returns all current `Message.labelIds` as part of the response in `messagesAdded`, `messagesDeleted`, `labelsAdded`, and `labelsRemoved`. ## June 18, 2015 Feature Added a [`Message.internalDate` field](https://developers.google.com/gmail/api/v1/reference/users/messages) that exposes the message's creation timestamp in the mailbox. ## May 29, 2015 Feature You can now send [push notifications](https://developers.google.com/gmail/api/guides/push) on mailbox updates, providing real-time server notification without the need for constant polling. With [Cloud Pub/Sub](https://cloud.google.com/pubsub/overview), you can now use webhooks---for example, to receive callbacks when updates happen. Additionally, you can filter these notifications to specific Gmail labels. ## March 31, 2015 Change New scopes for labels and inserting messages to better protect users and accommodate apps that don't need full mailbox data access: - `https://www.googleapis.com/auth/gmail.insert`: Allows the [`messages.insert`](https://developers.google.com/gmail/api/v1/reference/users/messages/insert) and [`messages.import`](https://developers.google.com/gmail/api/v1/reference/users/messages/import) methods only. - `https://www.googleapis.com/auth/gmail.labels`: Allows all [label operations](https://developers.google.com/gmail/api/v1/reference/users/labels). ## March 18, 2015 Feature The [`messages.insert` method](https://developers.google.com/gmail/api/v1/reference/users/messages/insert) now supports the `deleted` request parameter and lets you set `SENT` and `DRAFT` labels. ## February 25, 2015 Feature The [`history.list` method](https://developers.google.com/gmail/api/reference/rest/v1/users.history/list) now provides details of the change type in each history record. For example, using the `messagesAdded`, `messagesDeleted`, `labelsAdded`, or `labelsDeleted` enums, it's possible to easily tell how a message was changed and typically avoids the need for additional calls to synchronize your client. ## February 11, 2015 Feature The [`messages.import` method](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/import) now supports the following parameters to better support `Email Migration` use cases: - `neverMarkSpam` - `processForCalendar` - `deleted` ## January 23, 2015 Feature You can now specify `message.labelIds` on [`messages.import` requests](https://developers.google.com/gmail/api/v1/reference/users/messages/import) to automatically apply the given labels to the message. Breaking The default behavior no longer automatically adds `INBOX` and `UNREAD` labels to [`messages.import` emails](https://developers.google.com/gmail/api/v1/reference/users/messages/import). When `message.labelIds` isn't specified, imported mail is only visible in All Mail. If you want `INBOX` or `UNREAD` labels applied, specify them in the `message.labelIds` field. ## January 15, 2015 Change Increased the default [per-user quotas](https://developers.google.com/gmail/api/v1/reference/quota) from 25 units/user/second to 250 units/user/second and adjusted some method costs slightly. ## October 22, 2014 Feature You can now specify the return format for the [`threads.get` method](https://developers.google.com/gmail/api/v1/reference/users/threads/get). The available formats are `full`, `metadata`, and `minimal`, similar to the `messages.get` method. The raw format isn't allowed for the `threads.get` to avoid unexpectedly large amounts of data being returned. ## October 16, 2014 Feature The [`getProfile` method](https://developers.google.com/gmail/api/v1/reference/users/getProfile) provides mailbox-wide information like current history ID and total message and thread counts. ## October 06, 2014 Feature Added new fields to the `Labels` resource to simplify counting how many messages have a given label applied: - `messagesTotal` - `messagesUnread` - `threadsTotal` - `threadsUnread` Feature Added a new [`IMPORTANT` label](https://developers.google.com/gmail/api/guides/labels) to match functionality with the Gmail UI. ## September 25, 2014 Change The `messages.insert` method defaults to using `receivedTime` and the `messages.import` method defaults to using `dateHeader`. ## September 08, 2014 Change When you use the [`messages.get` method](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/get), you can request the metadata return format to return only the email headers and metadata such as identifiers and labels. ## September 02, 2014 Feature You can specify the `internalDateSource` for both the [`messages.insert`](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/insert) and [`messages.import`](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/import) methods. ## July 11, 2014 Change Quota costs for all methods in the API have been reduced by a factor of 10. For example, if a method previously cost 150 quota units, it now costs 15. For a complete list of API method costs, see the [per-method quota usage chart](https://developers.google.com/gmail/api/reference/quota#per-method_quota_usage). ## June 25, 2014 Announcement The Gmail API is publicly available! ## October 28, 2013 Feature The [Review Action](https://developers.google.com/gmail/markup/reference/review-action) is out of preview, and now available to all users. ## October 03, 2013 Feature The Schema Validator tool in [Testing Your Schemas](https://developers.google.com/gmail/markup/testing-your-schema) has been replaced with the new [Email Markup Tester](https://www.google.com/webmasters/markup-tester/). ## July 23, 2013 Feature It is now possible to use schemas to define [Orders](https://developers.google.com/gmail/markup/reference/order), [Parcel Deliveries](https://developers.google.com/gmail/markup/reference/parcel-delivery), and the [TrackAction](https://developers.google.com/gmail/markup/reference/go-to-action#track_action) to let users track packages being delivered. ## July 11, 2013 Feature The [RSVP Action](https://developers.google.com/gmail/markup/reference/rsvp-action) is now enabled for all emails sent by Google Calendar.