Skip to main content

ISESV2PutEmailIdentityMailFromAttributesRequest

Interface in AWS.SESV2

Interface for PutEmailIdentityMailFromAttributes requests.

Ancestors

Properties

EmailIdentity

property EmailIdentity: string

The verified email identity to configure custom Mail-From domain attributes for.

This must be a verified email address or domain in your Amazon SES account for which you want to enable or disable custom Mail-From domain configuration. The identity must be verified before Mail-From attributes can be configured. The email identity must be at least 1 character in length and can be either a single email address (e.g., user@example.com) or a domain (e.g., example.com).

BehaviourOnMxFailure

property BehaviourOnMxFailure: string

The action to take when the required MX record for the Mail-From domain cannot be found.

This setting determines the fallback behavior when the custom Mail-From domain configuration is in Pending, Failed, or TemporaryFailure states due to missing or invalid MX records. Supported behavior values:

  • USE_DEFAULT_VALUE – Send emails using amazonses.com as the Mail-From domain when MX record validation fails.
  • REJECT_MESSAGE – Reject the email and return a MailFromDomainNotVerified error instead of attempting delivery.

MailFromDomain

property MailFromDomain: string

The custom Mail-From domain to use for the verified identity.

This domain appears in the MAIL FROM field of email headers and must meet specific requirements to function properly with Amazon SES. The Mail-From domain must satisfy these criteria:

  • Must be a subdomain of the verified identity (e.g., mail.example.com for example.com).
  • Cannot be used to receive email directly.
  • Cannot be used in From addresses if it serves as a feedback forwarding destination. This field is optional. When not specified, the default Amazon SES Mail-From domain will be used for the identity.