Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Preferences
Contact Us
Feedback
AWS Documentation
Create an AWS Account
CreateReceiptRule - Amazon Simple Email Service
Request ParametersErrorsSee Also

CreateReceiptRule

PDF

Creates a receipt rule.

For information about setting up receipt rules, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

After

The name of an existing rule after which the new rule is placed. If this parameter is null, the new rule is inserted at the beginning of the rule list.

Type: String

Required: No

Rule

A data structure that contains the specified rule's name, actions, recipients, domains, enabled status, scan status, and TLS policy.

Type: ReceiptRule object

Required: Yes

RuleSetName

The name of the rule set where the receipt rule is added.

Type: String

Required: Yes

Errors

For information about the errors that are common to all actions, see Common Errors.

AlreadyExists

Indicates that a resource could not be created because of a naming conflict.

HTTP Status Code: 400

InvalidLambdaFunction

Indicates that the provided AWS Lambda function is invalid, or that Amazon SES could not execute the provided function, possibly due to permissions issues. For information about giving permissions, see the Amazon SES Developer Guide.

HTTP Status Code: 400

InvalidS3Configuration

Indicates that the provided Amazon S3 bucket or AWS KMS encryption key is invalid, or that Amazon SES could not publish to the bucket, possibly due to permissions issues. For information about giving permissions, see the Amazon SES Developer Guide.

HTTP Status Code: 400

InvalidSnsTopic

Indicates that the provided Amazon SNS topic is invalid, or that Amazon SES could not publish to the topic, possibly due to permissions issues. For information about giving permissions, see the Amazon SES Developer Guide.

HTTP Status Code: 400

LimitExceeded

Indicates that a resource could not be created because of service limits. For a list of Amazon SES limits, see the Amazon SES Developer Guide.

HTTP Status Code: 400

RuleDoesNotExist

Indicates that the provided receipt rule does not exist.

HTTP Status Code: 400

RuleSetDoesNotExist

Indicates that the provided receipt rule set does not exist.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

Previous topic:

CreateReceiptFilter

Need help?

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.