Google: Updates the auto-forwarding setting for the specified account A verified forwarding address must be specified when auto-forwarding is enabled For more information, see Manage email forwarding (https: developers google com workspace gmail api guides forwarding settings) This method is only available to service account clients that have been delegated domain-wide authority — request body — body
Updates the auto-forwarding setting for the specified account. A verified forwarding address must be specified when auto-forwarding is enabled. For more information, see [Manage email forwarding](https://developers.google.com/workspace/gmail/api/guides/forwarding_settings). This method is only available to service account clients that have been delegated domain-wide authority.: request body, field body. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Updates the auto-forwarding setting for the specified account A verified forwarding address must be specified when auto-forwarding is enabled For more information, see Manage email forwarding (https: developers google com workspace gmail api guides forwarding settings) This method is only available to service account clients that have been delegated domain-wide authority — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Auto-forwarding settings for an account. |
disposition | string | Optional | The state that a message should be left in after it has been forwarded. One of: dispositionUnspecified, leaveInInbox, archive, trash, markRead |
emailAddress | string | Optional | Email address to which all incoming messages are forwarded. This email address must be a verified member of the forwarding addresses. |
enabled | boolean | Optional | Whether all incoming mail is automatically forwarded to another address. |