overcast local AWS emulator

Service Reference

SES — Simple Email Service

SES supports both the v1 Query protocol (form-encoded POST with Action field, XML responses) and the v2 REST-JSON protocol (path-based routing, JSON request/response bodies).

SES — Simple Email Service

AWS docs: https://docs.aws.amazon.com/ses/latest/APIReference/Welcome.html SES v2 docs: https://docs.aws.amazon.com/ses/latest/APIReference-V2/Welcome.html

SES supports both the v1 Query protocol (form-encoded POST with Action field, XML responses) and the v2 REST-JSON protocol (path-based routing, JSON request/response bodies).

[!NOTE] Emails are not delivered — all outbound messages are captured and visible in the Mail page of the web console. All identities are automatically verified; there is no real verification flow.


SDK compatibility

SDKClientStatus
Go v2aws-sdk-go-v2/service/ses✅ Tested
Go v2aws-sdk-go-v2/service/sesv2✅ Tested
Python (boto3)boto3.client("ses")✅ Expected
Python (boto3)boto3.client("sesv2")✅ Expected
JS/TS v3@aws-sdk/client-ses✅ Expected
JS/TS v3@aws-sdk/client-sesv2✅ Expected

Web console

The SES page (/ses) shows all verified identities with the ability to add new email/domain identities and delete existing ones. Emails sent via SES appear in the Mail page.

Summary

Category✅ Supported❌ Unsupported
SES v1 — Sending2
SES v1 — Identities97
SES v1 — Templates6
SES v1 — Other210
SES v2 — Sending1
SES v2 — Identities4
SES v2 — Tags3
SES v2 — Other1

Endpoints

SES v1 — Sending

OperationStatusNotesAWS Docs
SendEmail✅ SupportedQuery Action=SendEmail; simple contentdocs
SendRawEmail✅ SupportedDelivers raw MIME to mail capturedocs

SES v1 — Identities

OperationStatusNotesAWS Docs
VerifyEmailIdentity✅ SupportedAuto-verifieddocs
VerifyDomainIdentity✅ SupportedAuto-verified; returns dummy tokendocs
ListIdentities✅ SupportedSupports IdentityType filterdocs
ListVerifiedEmailAddresses✅ Supporteddocs
GetIdentityVerificationAttributes✅ SupportedAlways returns Success statusdocs
DeleteIdentity✅ Supporteddocs
VerifyEmailAddress✅ Supporteddocs
DeleteVerifiedEmailAddress✅ Supporteddocs
SetIdentityFeedbackForwardingEnabled✅ Supporteddocs
GetIdentityDkimAttributes❌ Unsupportedstub; returns 501docs
GetIdentityMailFromDomainAttributes❌ Unsupportedstub; returns 501docs
GetIdentityNotificationAttributes❌ Unsupportedstub; returns 501docs
SetIdentityDkimEnabled❌ Unsupportedstub; returns 501docs
SetIdentityMailFromDomain❌ Unsupportedstub; returns 501docs
SetIdentityNotificationTopic❌ Unsupportedstub; returns 501docs
VerifyDomainDkim❌ Unsupportedstub; returns 501docs

SES v1 — Templates

OperationStatusNotesAWS Docs
CreateTemplate✅ Supporteddocs
GetTemplate✅ Supporteddocs
UpdateTemplate✅ Supporteddocs
ListTemplates✅ Supporteddocs
DeleteTemplate✅ Supporteddocs
SendTemplatedEmail✅ Supported{{key}} variable substitutiondocs

SES v1 — Other

OperationStatusNotesAWS Docs
GetSendQuota✅ SupportedReturns unlimited quotadocs
GetSendStatistics✅ SupportedReturns empty data pointsdocs
CreateConfigurationSet❌ Unsupportedstub; returns 501docs
DeleteConfigurationSet❌ Unsupportedstub; returns 501docs
ListConfigurationSets❌ Unsupportedstub; returns 501docs
CreateReceiptRule❌ Unsupportedstub; returns 501docs
CreateReceiptRuleSet❌ Unsupportedstub; returns 501docs
DeleteReceiptRule❌ Unsupportedstub; returns 501docs
DeleteReceiptRuleSet❌ Unsupportedstub; returns 501docs
DescribeReceiptRule❌ Unsupportedstub; returns 501docs
DescribeReceiptRuleSet❌ Unsupportedstub; returns 501docs
ListReceiptRuleSets❌ Unsupportedstub; returns 501docs

SES v2 — Sending

OperationStatusNotesAWS Docs
SendEmail✅ SupportedPOST /v2/email/outbound-emails; simple contentdocs

SES v2 — Identities

OperationStatusNotesAWS Docs
CreateEmailIdentity✅ SupportedPOST /v2/email/identities; auto-verified; inline Tags applied at creationdocs
ListEmailIdentities✅ SupportedGET /v2/email/identitiesdocs
GetEmailIdentity✅ SupportedGET /v2/email/identities/{EmailIdentity}; reports the identity’s Tagsdocs
DeleteEmailIdentity✅ SupportedDELETE /v2/email/identities/{EmailIdentity}docs

SES v2 — Tags

OperationStatusNotesAWS Docs
TagResource✅ SupportedPOST /v2/email/tags; email identity ARNs — configuration sets are not emulateddocs
UntagResource✅ SupportedDELETE /v2/email/tags?ResourceArn=…&TagKeys=…docs
ListTagsForResource✅ SupportedGET /v2/email/tags?ResourceArn=…docs

SES v2 — Other

OperationStatusNotesAWS Docs
All other v2 operations❌ UnsupportedReturns NotImplementeddocs