POST

/v2/email/configuration-sets

http://email.{region}.amazonaws.com/v2/email/configuration-sets

Create a configuration set. Configuration sets are groups of rules that you can apply to the emails that you send. You apply a configuration set to an email by specifying the name of the configuration set when you call the Amazon SES API v2. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.

Access Token Required: API Key

Body Params

Tagsarray

An array of objects that define the tags (keys and values) to associate with the configuration set.

VdmOptionsobject

An object that defines the VDM settings that apply to emails that you send using the configuration set.

SendingOptionsobject

Used to enable or disable email sending for messages that use this configuration set in the current Amazon Web Services Region.

DeliveryOptionsobject

Used to associate a configuration set with a dedicated IP pool.

TrackingOptionsobject

An object that defines the tracking options for a configuration set. When you use the Amazon SES API v2 to send an email, it contains an invisible image that's used to track when recipients open your email. If your email contains links, those links are changed slightly in order to track when recipients click them. These images and links include references to a domain operated by Amazon Web Services. You can optionally configure the Amazon SES to use a domain that you operate for these images and links.

ReputationOptionsobject

Enable or disable collection of reputation metrics for emails that you send using this configuration set in the current Amazon Web Services Region.

SuppressionOptionsobject

An object that contains information about the suppression list preferences for your account.

ConfigurationSetNamestringrequired

The name of a configuration set. Configuration sets are groups of rules that you can apply to the emails you send. You apply a configuration set to an email by including a reference to the configuration set in the headers of the email. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://email.{region}.amazonaws.com/v2/email/configuration-sets' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}