Skip to content

Google: Creates a forwarding address If ownership verification is required, a message will be sent to the recipient and the resource's verification status will be set to `pending`; otherwise, the resource will be created with verification status set to `accepted` 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

Creates a forwarding address. If ownership verification is required, a message will be sent to the recipient and the resource's verification status will be set to `pending`; otherwise, the resource will be created with verification status set to `accepted`. 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: Creates a forwarding address If ownership verification is required, a message will be sent to the recipient and the resource's verification status will be set to `pending`; otherwise, the resource will be created with verification status set to `accepted` 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

FieldTypePresenceDescription and constraints
$objectRootSettings for a forwarding address.
forwardingEmailstringOptionalAn email address to which messages can be forwarded.
verificationStatusstringOptionalIndicates whether this address has been verified and is usable for forwarding. Read-only.
One of: verificationStatusUnspecified, accepted, pending

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.