Google: Updates IMAP settings For more information, see Configure POP and IMAP settings with the Gmail API (https: developers google com workspace gmail api guides pop imap settings) — request body — body
Updates IMAP settings. For more information, see [Configure POP and IMAP settings with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/pop_imap_settings).: request body, field body. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Updates IMAP settings For more information, see Configure POP and IMAP settings with the Gmail API (https: developers google com workspace gmail api guides pop imap settings) — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | IMAP settings for an account. |
autoExpunge | boolean | Optional | If this value is true, Gmail will immediately expunge a message when it is marked as deleted in IMAP. Otherwise, Gmail will wait for an update from the client before expunging messages marked as deleted. |
enabled | boolean | Optional | Whether IMAP is enabled for the account. |
expungeBehavior | string | Optional | The action that will be executed on a message when it is marked as deleted and expunged from the last visible IMAP folder. One of: expungeBehaviorUnspecified, archive, trash, deleteForever |
maxFolderSize | integer | Optional | An optional limit on the number of messages that an IMAP folder may contain. Legal values are 0, 1000, 2000, 5000 or 10000. A value of zero is interpreted to mean that there is no limit. Format: int32 |