Skip to content

Google: Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body

Lists the history of all changes to the given mailbox. History results are returned in chronological order (increasing `historyId`). For more information, see [Synchronize clients with Gmail](https://developers.google.com/workspace/gmail/api/guides/sync).: response body. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body

FieldTypePresenceDescription and constraints
$objectRoot
historyarrayOptionalList of history records. Any `messages` contained in the response will typically only have `id` and `threadId` fields populated.
history[]ModelEach itemExpand Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item
historyIdstringOptionalThe ID of the mailbox’s current history record.
Format: uint64
nextPageTokenstringOptionalPage token to retrieve the next page of results in the list.

Referenced models: Lists the history of all changes to the given mailbox History results are returned in chronological order (increasing `history Id`) For more information, see Synchronize clients with Gmail (https: developers google com workspace gmail api guides sync) — response body — history item

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.