put_email_identity_mail_from_attributes

put_email_identity_mail_from_attributes(**kwargs)

Used to enable or disable the custom Mail-From domain configuration for an email identity.

See also: AWS API Documentation

Request Syntax

response = client.put_email_identity_mail_from_attributes(
    EmailIdentity='string',
    MailFromDomain='string',
    BehaviorOnMxFailure='USE_DEFAULT_VALUE'|'REJECT_MESSAGE'
)
Parameters
  • EmailIdentity (string) --

    [REQUIRED]

    The verified email identity that you want to set up the custom MAIL FROM domain for.

  • MailFromDomain (string) --

    The custom MAIL FROM domain that you want the verified identity to use. The MAIL FROM domain must meet the following criteria:

    • It has to be a subdomain of the verified identity.
    • It can't be used to receive email.
    • It can't be used in a "From" address if the MAIL FROM domain is a destination for feedback forwarding emails.
  • BehaviorOnMxFailure (string) --

    The action that you want Amazon Pinpoint to take if it can't read the required MX record when you send an email. When you set this value to UseDefaultValue , Amazon Pinpoint uses amazonses.com as the MAIL FROM domain. When you set this value to RejectMessage , Amazon Pinpoint returns a MailFromDomainNotVerified error, and doesn't attempt to deliver the email.

    These behaviors are taken when the custom MAIL FROM domain configuration is in the Pending , Failed , and TemporaryFailure states.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    An HTTP 200 response if the request succeeds, or an error message if the request fails.

Exceptions

  • PinpointEmail.Client.exceptions.NotFoundException
  • PinpointEmail.Client.exceptions.TooManyRequestsException
  • PinpointEmail.Client.exceptions.BadRequestException