AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
This is the API Reference for Amazon Simple Email Service (Amazon SES). This documentation is intended to be used in conjunction with the Amazon SES Developer Guide.
Namespace: Amazon.SimpleEmail
Assembly: AWSSDK.dll
Version: (assembly version)
public interface IAmazonSimpleEmailService IDisposable
The IAmazonSimpleEmailService type exposes the following members
Name | Description | |
---|---|---|
CloneReceiptRuleSet(CloneReceiptRuleSetRequest) |
Creates a receipt rule set by cloning an existing one. All receipt rules and configurations
are copied to the new receipt rule set and are completely independent of the source
rule set.
For information about setting up rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
CloneReceiptRuleSetAsync(CloneReceiptRuleSetRequest, CancellationToken) | Initiates the asynchronous execution of the CloneReceiptRuleSet operation. | |
CreateReceiptFilter(CreateReceiptFilterRequest) |
Creates a new IP address filter.
For information about setting up IP address filters, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
CreateReceiptFilterAsync(CreateReceiptFilterRequest, CancellationToken) | Initiates the asynchronous execution of the CreateReceiptFilter operation. | |
CreateReceiptRule(CreateReceiptRuleRequest) |
Creates a receipt rule.
For information about setting up receipt rules, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
CreateReceiptRuleAsync(CreateReceiptRuleRequest, CancellationToken) | Initiates the asynchronous execution of the CreateReceiptRule operation. | |
CreateReceiptRuleSet(CreateReceiptRuleSetRequest) |
Creates an empty receipt rule set.
For information about setting up receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
CreateReceiptRuleSetAsync(CreateReceiptRuleSetRequest, CancellationToken) | Initiates the asynchronous execution of the CreateReceiptRuleSet operation. | |
DeleteIdentity(DeleteIdentityRequest) |
Deletes the specified identity (email address or domain) from the list of verified
identities.
This action is throttled at one request per second. |
|
DeleteIdentityAsync(DeleteIdentityRequest, CancellationToken) | Initiates the asynchronous execution of the DeleteIdentity operation. | |
DeleteIdentityPolicy(DeleteIdentityPolicyRequest) |
Deletes the specified sending authorization policy for the given identity (email address
or domain). This API returns successfully even if a policy with the specified name
does not exist.
Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DeleteIdentityPolicyAsync(DeleteIdentityPolicyRequest, CancellationToken) | Initiates the asynchronous execution of the DeleteIdentityPolicy operation. | |
DeleteReceiptFilter(DeleteReceiptFilterRequest) |
Deletes the specified IP address filter.
For information about managing IP address filters, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DeleteReceiptFilterAsync(DeleteReceiptFilterRequest, CancellationToken) | Initiates the asynchronous execution of the DeleteReceiptFilter operation. | |
DeleteReceiptRule(DeleteReceiptRuleRequest) |
Deletes the specified receipt rule.
For information about managing receipt rules, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DeleteReceiptRuleAsync(DeleteReceiptRuleRequest, CancellationToken) | Initiates the asynchronous execution of the DeleteReceiptRule operation. | |
DeleteReceiptRuleSet(DeleteReceiptRuleSetRequest) |
Deletes the specified receipt rule set and all of the receipt rules it contains.
For information about managing receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DeleteReceiptRuleSetAsync(DeleteReceiptRuleSetRequest, CancellationToken) | Initiates the asynchronous execution of the DeleteReceiptRuleSet operation. | |
DeleteVerifiedEmailAddress(DeleteVerifiedEmailAddressRequest) |
Deletes the specified email address from the list of verified addresses.
This action is throttled at one request per second. |
|
DeleteVerifiedEmailAddressAsync(DeleteVerifiedEmailAddressRequest, CancellationToken) | Initiates the asynchronous execution of the DeleteVerifiedEmailAddress operation. | |
DescribeActiveReceiptRuleSet(DescribeActiveReceiptRuleSetRequest) |
Returns the metadata and receipt rules for the receipt rule set that is currently
active.
For information about setting up receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DescribeActiveReceiptRuleSetAsync(DescribeActiveReceiptRuleSetRequest, CancellationToken) | Initiates the asynchronous execution of the DescribeActiveReceiptRuleSet operation. | |
DescribeReceiptRule(DescribeReceiptRuleRequest) |
Returns the details of the specified receipt rule.
For information about setting up receipt rules, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DescribeReceiptRuleAsync(DescribeReceiptRuleRequest, CancellationToken) | Initiates the asynchronous execution of the DescribeReceiptRule operation. | |
DescribeReceiptRuleSet(DescribeReceiptRuleSetRequest) |
Returns the details of the specified receipt rule set.
For information about managing receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DescribeReceiptRuleSetAsync(DescribeReceiptRuleSetRequest, CancellationToken) | Initiates the asynchronous execution of the DescribeReceiptRuleSet operation. | |
GetIdentityDkimAttributes(GetIdentityDkimAttributesRequest) |
Returns the current status of Easy DKIM signing for an entity. For domain name identities,
this action also returns the DKIM tokens that are required for Easy DKIM signing,
and whether Amazon SES has successfully verified that these tokens have been published.
This action takes a list of identities as input and returns the following information for each:
This action is throttled at one request per second and can only get DKIM attributes for up to 100 identities at a time. For more information about creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide. |
|
GetIdentityDkimAttributesAsync(GetIdentityDkimAttributesRequest, CancellationToken) | Initiates the asynchronous execution of the GetIdentityDkimAttributes operation. | |
GetIdentityNotificationAttributes(GetIdentityNotificationAttributesRequest) |
Given a list of verified identities (email addresses and/or domains), returns a structure
describing identity notification attributes.
This action is throttled at one request per second and can only get notification attributes for up to 100 identities at a time. For more information about using notifications with Amazon SES, see the Amazon SES Developer Guide. |
|
GetIdentityNotificationAttributesAsync(GetIdentityNotificationAttributesRequest, CancellationToken) | Initiates the asynchronous execution of the GetIdentityNotificationAttributes operation. | |
GetIdentityPolicies(GetIdentityPoliciesRequest) |
Returns the requested sending authorization policies for the given identity (email
address or domain). The policies are returned as a map of policy names to policy contents.
You can retrieve a maximum of 20 policies at a time.
Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
GetIdentityPoliciesAsync(GetIdentityPoliciesRequest, CancellationToken) | Initiates the asynchronous execution of the GetIdentityPolicies operation. | |
GetIdentityVerificationAttributes(GetIdentityVerificationAttributesRequest) |
Given a list of identities (email addresses and/or domains), returns the verification
status and (for domain identities) the verification token for each identity.
This action is throttled at one request per second and can only get verification attributes for up to 100 identities at a time. |
|
GetIdentityVerificationAttributesAsync(GetIdentityVerificationAttributesRequest, CancellationToken) | Initiates the asynchronous execution of the GetIdentityVerificationAttributes operation. | |
GetSendQuota() |
Returns the user's current sending limits.
This action is throttled at one request per second. |
|
GetSendQuota(GetSendQuotaRequest) |
Returns the user's current sending limits.
This action is throttled at one request per second. |
|
GetSendQuotaAsync(GetSendQuotaRequest, CancellationToken) | Initiates the asynchronous execution of the GetSendQuota operation. | |
GetSendStatistics() |
Returns the user's sending statistics. The result is a list of data points, representing
the last two weeks of sending activity.
Each data point in the list contains statistics for a 15-minute interval. This action is throttled at one request per second. |
|
GetSendStatistics(GetSendStatisticsRequest) |
Returns the user's sending statistics. The result is a list of data points, representing
the last two weeks of sending activity.
Each data point in the list contains statistics for a 15-minute interval. This action is throttled at one request per second. |
|
GetSendStatisticsAsync(GetSendStatisticsRequest, CancellationToken) | Initiates the asynchronous execution of the GetSendStatistics operation. | |
ListIdentities() |
Returns a list containing all of the identities (email addresses and domains) for
a specific AWS Account, regardless of verification status.
This action is throttled at one request per second. |
|
ListIdentities(ListIdentitiesRequest) |
Returns a list containing all of the identities (email addresses and domains) for
a specific AWS Account, regardless of verification status.
This action is throttled at one request per second. |
|
ListIdentitiesAsync(ListIdentitiesRequest, CancellationToken) | Initiates the asynchronous execution of the ListIdentities operation. | |
ListIdentityPolicies(ListIdentityPoliciesRequest) |
Returns a list of sending authorization policies that are attached to the given identity
(email address or domain). This API returns only a list. If you want the actual policy
content, you can use GetIdentityPolicies .
Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
ListIdentityPoliciesAsync(ListIdentityPoliciesRequest, CancellationToken) | Initiates the asynchronous execution of the ListIdentityPolicies operation. | |
ListReceiptFilters(ListReceiptFiltersRequest) |
Lists the IP address filters associated with your account.
For information about managing IP address filters, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
ListReceiptFiltersAsync(ListReceiptFiltersRequest, CancellationToken) | Initiates the asynchronous execution of the ListReceiptFilters operation. | |
ListReceiptRuleSets(ListReceiptRuleSetsRequest) |
Lists the receipt rule sets that exist under your AWS account. If there are additional
receipt rule sets to be retrieved, you will receive a NextToken that
you can provide to the next call to ListReceiptRuleSets to retrieve the
additional entries.
For information about managing receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
ListReceiptRuleSetsAsync(ListReceiptRuleSetsRequest, CancellationToken) | Initiates the asynchronous execution of the ListReceiptRuleSets operation. | |
ListVerifiedEmailAddresses() |
Returns a list containing all of the email addresses that have been verified.
This action is throttled at one request per second. |
|
ListVerifiedEmailAddresses(ListVerifiedEmailAddressesRequest) |
Returns a list containing all of the email addresses that have been verified.
This action is throttled at one request per second. |
|
ListVerifiedEmailAddressesAsync(ListVerifiedEmailAddressesRequest, CancellationToken) | Initiates the asynchronous execution of the ListVerifiedEmailAddresses operation. | |
PutIdentityPolicy(PutIdentityPolicyRequest) |
Adds or updates a sending authorization policy for the specified identity (email address
or domain).
Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
PutIdentityPolicyAsync(PutIdentityPolicyRequest, CancellationToken) | Initiates the asynchronous execution of the PutIdentityPolicy operation. | |
ReorderReceiptRuleSet(ReorderReceiptRuleSetRequest) |
Reorders the receipt rules within a receipt rule set.
For information about managing receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
ReorderReceiptRuleSetAsync(ReorderReceiptRuleSetRequest, CancellationToken) | Initiates the asynchronous execution of the ReorderReceiptRuleSet operation. | |
SendBounce(SendBounceRequest) |
Generates and sends a bounce message to the sender of an email you received through
Amazon SES. You can only use this API on an email up to 24 hours after you receive
it.
For information about receiving email through Amazon SES, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
SendBounceAsync(SendBounceRequest, CancellationToken) | Initiates the asynchronous execution of the SendBounce operation. | |
SendEmail(SendEmailRequest) |
Composes an email message based on input data, and then immediately queues the message
for sending.
There are several important points to know about
|
|
SendEmailAsync(SendEmailRequest, CancellationToken) | Initiates the asynchronous execution of the SendEmail operation. | |
SendRawEmail(SendRawEmailRequest) |
Sends an email message, with header and content specified by the client. The SendRawEmail
action is useful for sending multipart MIME emails. The raw text of the message must
comply with Internet email standards; otherwise, the message cannot be sent.
There are several important points to know about
|
|
SendRawEmailAsync(SendRawEmailRequest, CancellationToken) | Initiates the asynchronous execution of the SendRawEmail operation. | |
SetActiveReceiptRuleSet(SetActiveReceiptRuleSetRequest) |
Sets the specified receipt rule set as the active receipt rule set.
For information about managing receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
SetActiveReceiptRuleSetAsync(SetActiveReceiptRuleSetRequest, CancellationToken) | Initiates the asynchronous execution of the SetActiveReceiptRuleSet operation. | |
SetIdentityDkimEnabled(SetIdentityDkimEnabledRequest) |
Enables or disables Easy DKIM signing of email sent from an identity:
For email addresses (e.g., This action is throttled at one request per second. For more information about Easy DKIM signing, go to the Amazon SES Developer Guide. |
|
SetIdentityDkimEnabledAsync(SetIdentityDkimEnabledRequest, CancellationToken) | Initiates the asynchronous execution of the SetIdentityDkimEnabled operation. | |
SetIdentityFeedbackForwardingEnabled(SetIdentityFeedbackForwardingEnabledRequest) |
Given an identity (email address or domain), enables or disables whether Amazon SES
forwards bounce and complaint notifications as email. Feedback forwarding can only
be disabled when Amazon Simple Notification Service (Amazon SNS) topics are specified
for both bounces and complaints.
This action is throttled at one request per second. For more information about using notifications with Amazon SES, see the Amazon SES Developer Guide. |
|
SetIdentityFeedbackForwardingEnabledAsync(SetIdentityFeedbackForwardingEnabledRequest, CancellationToken) | Initiates the asynchronous execution of the SetIdentityFeedbackForwardingEnabled operation. | |
SetIdentityNotificationTopic(SetIdentityNotificationTopicRequest) |
Given an identity (email address or domain), sets the Amazon Simple Notification Service
(Amazon SNS) topic to which Amazon SES will publish bounce, complaint, and/or delivery
notifications for emails sent with that identity as the Source .
SetIdentityFeedbackForwardingEnabled .
This action is throttled at one request per second. For more information about feedback notification, see the Amazon SES Developer Guide. |
|
SetIdentityNotificationTopicAsync(SetIdentityNotificationTopicRequest, CancellationToken) | Initiates the asynchronous execution of the SetIdentityNotificationTopic operation. | |
SetReceiptRulePosition(SetReceiptRulePositionRequest) |
Sets the position of the specified receipt rule in the receipt rule set.
For information about managing receipt rules, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
SetReceiptRulePositionAsync(SetReceiptRulePositionRequest, CancellationToken) | Initiates the asynchronous execution of the SetReceiptRulePosition operation. | |
UpdateReceiptRule(UpdateReceiptRuleRequest) |
Updates a receipt rule.
For information about managing receipt rules, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
UpdateReceiptRuleAsync(UpdateReceiptRuleRequest, CancellationToken) | Initiates the asynchronous execution of the UpdateReceiptRule operation. | |
VerifyDomainDkim(VerifyDomainDkimRequest) |
Returns a set of DKIM tokens for a domain. DKIM tokens are character strings
that represent your domain's identity. Using these tokens, you will need to create
DNS CNAME records that point to DKIM public keys hosted by Amazon SES. Amazon Web
Services will eventually detect that you have updated your DNS records; this detection
process may take up to 72 hours. Upon successful detection, Amazon SES will be able
to DKIM-sign email originating from that domain.
This action is throttled at one request per second.
To enable or disable Easy DKIM signing for a domain, use the For more information about creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide. |
|
VerifyDomainDkimAsync(VerifyDomainDkimRequest, CancellationToken) | Initiates the asynchronous execution of the VerifyDomainDkim operation. | |
VerifyDomainIdentity(VerifyDomainIdentityRequest) |
Verifies a domain.
This action is throttled at one request per second. |
|
VerifyDomainIdentityAsync(VerifyDomainIdentityRequest, CancellationToken) | Initiates the asynchronous execution of the VerifyDomainIdentity operation. | |
VerifyEmailAddress(VerifyEmailAddressRequest) |
Verifies an email address. This action causes a confirmation email message to be sent
to the specified address.
This action is throttled at one request per second. |
|
VerifyEmailAddressAsync(VerifyEmailAddressRequest, CancellationToken) | Initiates the asynchronous execution of the VerifyEmailAddress operation. | |
VerifyEmailIdentity(VerifyEmailIdentityRequest) |
Verifies an email address. This action causes a confirmation email message to be sent
to the specified address.
This action is throttled at one request per second. |
|
VerifyEmailIdentityAsync(VerifyEmailIdentityRequest, CancellationToken) | Initiates the asynchronous execution of the VerifyEmailIdentity operation. |
This example shows how to send an email.
var sesClient = new AmazonSimpleEmailServiceClient(); var dest = new Destination { ToAddresses = new List<string>() { "janedoe@example.com" }, CcAddresses = new List<string>() { "richarddoe@example.com" } }; var from = "johndoe@example.com"; var subject = new Content("You're invited to the meeting"); var body = new Body(new Content("Please join us Monday at 7:00 PM.")); var msg = new Message(subject, body); var request = new SendEmailRequest { Destination = dest, Message = msg, Source = from }; sesClient.SendEmail(request);
.NET Framework:
Supported in: 4.5, 4.0, 3.5
.NET for Windows Store apps:
Supported in: Windows 8.1, Windows 8
.NET for Windows Phone:
Supported in: Windows Phone 8.1, Windows Phone 8