Send email via SESv2 using mailbox format

[lonix1]

Describe the issue

It is common to use the "mailbox" format for email addresses, e.g. "John Doe <johndoe@example.com>".

I tried that with SESv2 client.SendEmailAsync and it worked.

However, it is not documented anywhere and I fear it may not be an officially supported use case.

Can someone please confirm whether this format is allowed? (If so, maybe the docs could be updated to reflect that.)

Links

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/SimpleEmailV2/TSendEmailRequest.html

[ashishdhingra]

@lonix1 Good afternoon. Thanks for reporting the issue. The API documentation for AWS SDK .NET is generated from service models shared by the service team. For instance, if you compare the .NET API reference https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/SimpleEmailV2/TDestination.html and service API reference https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html, both are similar.

Most SMTP servers support mailbox format. If you check SES developer guide at Email format in Amazon SES, it shows example on how it SES constructs an email message compliant with the Internet Message Format specification (RFC 5322). The example demonstrates mailbox format. If you think it would be helpful to explicitly call this out in SES developer guide or API, please use the Provide Feedback link at the bottom of Email format in Amazon SES page, so that it is directed to the correct team. Please let me know if you have any further questions.

Thanks,
Ashish

[github-actions]

Comments on closed issues are hard for our team to see.
If you need more assistance, please either tag a team member or open a new issue that references this one.
If you wish to keep having a conversation with other community members under this issue feel free to do so.