Stay organized with collections Save and categorize content based on your preferences.
Resource: SendAsSettings associated with a send-as alias, which can be either the primary login address associated with the account or a custom "from" address. Send-as aliases correspond to the "Send Mail As" feature in the web interface.
JSON representation{ "sendAsEmail": string, "displayName": string, "replyToAddress": string, "signature": string, "isPrimary": boolean, "isDefault": boolean, "treatAsAlias": boolean, "smtpMsa": { object (FieldsSmtpMsa
) }, "verificationStatus": enum (VerificationStatus
) }
sendAsEmail
string
The email address that appears in the "From:" header for mail sent using this alias. This is read-only for all operations except create.
displayName
string
A name that appears in the "From:" header for mail sent using this alias. For custom "from" addresses, when this is empty, Gmail will populate the "From:" header with the name that is used for the primary address associated with the account. If the admin has disabled the ability for users to update their name format, requests to update this field for the primary login will silently fail.
replyToAddress
string
An optional email address that is included in a "Reply-To:" header for mail sent using this alias. If this is empty, Gmail will not generate a "Reply-To:" header.
signature
string
An optional HTML signature that is included in messages composed with this alias in the Gmail web UI. This signature is added to new emails only.
isPrimary
boolean
Whether this address is the primary address used to login to the account. Every Gmail account has exactly one primary address, and it cannot be deleted from the collection of send-as aliases. This field is read-only.
isDefault
boolean
Whether this address is selected as the default "From:" address in situations such as composing a new message or sending a vacation auto-reply. Every Gmail account has exactly one default send-as address, so the only legal value that clients may write to this field is true
. Changing this from false
to true
for an address will result in this field becoming false
for the other previous default address.
treatAsAlias
boolean
Whether Gmail should treat this address as an alias for the user's primary email address. This setting only applies to custom "from" aliases.
smtpMsa
object (
SmtpMsa
)
An optional SMTP service that will be used as an outbound relay for mail sent using this alias. If this is empty, outbound mail will be sent directly from Gmail's servers to the destination SMTP service. This setting only applies to custom "from" aliases.
verificationStatus
enum (
VerificationStatus
)
Indicates whether this address has been verified for use as a send-as alias. Read-only. This setting only applies to custom "from" aliases.
SmtpMsaConfiguration for communication with an SMTP service.
JSON representation{
"host": string,
"port": integer,
"username": string,
"password": string,
"securityMode": enum (SecurityMode
)
}
Fields host
string
The hostname of the SMTP service. Required.
port
integer
The port of the SMTP service. Required.
username
string
The username that will be used for authentication with the SMTP service. This is a write-only field that can be specified in requests to create or update SendAs settings; it is never populated in responses.
password
string
The password that will be used for authentication with the SMTP service. This is a write-only field that can be specified in requests to create or update SendAs settings; it is never populated in responses.
securityMode
enum (
SecurityMode
)
The protocol that will be used to secure communication with the SMTP service. Required.
SecurityModeA protocol that may be used to secure communication with the SMTP service.
EnumssecurityModeUnspecified
Unspecified security mode. none
Communication with the remote SMTP service is unsecured. Requires port 25. ssl
Communication with the remote SMTP service is secured using SSL. starttls
Communication with the remote SMTP service is secured using STARTTLS. VerificationStatus
Indicates whether ownership of an address has been verified for its use as a send-as alias.
EnumsverificationStatusUnspecified
Unspecified verification status. accepted
The address is ready to use as a send-as alias. pending
The address is awaiting verification by the owner. Methods create
Creates a custom "from" send-as alias. delete
Deletes the specified send-as alias. get
Gets the specified send-as alias. list
Lists the send-as aliases for the specified account. patch
Patch the specified send-as alias. update
Updates a send-as alias. verify
Sends a verification email to the specified send-as alias address.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-24 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-24 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4