Menu
Amazon Simple Email Service
API Reference (API Version 2010-12-01)

CreateReceiptRule

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 will be placed. If this parameter is null, the new rule will be 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 that the receipt rule will be added to.

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: