# AutoForwarding

- [JSON representation](https://developers.google.com/workspace/gmail/api/reference/rest/v1/AutoForwarding#SCHEMA_REPRESENTATION)
- [Disposition](https://developers.google.com/workspace/gmail/api/reference/rest/v1/AutoForwarding#Disposition)

Auto-forwarding settings for an account.

| JSON representation |
|---|
| ``` { "enabled": boolean, "emailAddress": string, "disposition": enum (`https://developers.google.com/workspace/gmail/api/reference/rest/v1/AutoForwarding#Disposition`) } ``` |

| Fields ||
|---|---|
| `enabled` | `boolean` Whether all incoming mail is automatically forwarded to another address. |
| `emailAddress` | `string` Email address to which all incoming messages are forwarded. This email address must be a verified member of the forwarding addresses. |
| `disposition` | ``enum (`https://developers.google.com/workspace/gmail/api/reference/rest/v1/AutoForwarding#Disposition`)`` The state that a message should be left in after it has been forwarded. |

## Disposition

Specifies what Gmail should do with a message after it has been automatically forwarded.

| Enums ||
|---|---|
| `dispositionUnspecified` | Unspecified disposition. |
| `leaveInInbox` | Leave the message in the `INBOX`. |
| `archive` | Archive the message. |
| `trash` | Move the message to the `TRASH`. |
| `markRead` | Leave the message in the `INBOX` and mark it as read. |