---
title: "POST /v2/email/configuration-sets"
method: POST
path: "/v2/email/configuration-sets"
---

# POST /v2/email/configuration-sets

`POST /v2/email/configuration-sets`

Create a configuration set. <i>Configuration sets</i> 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.

## Request body

- object
  - `ConfigurationSetName` string, required — <p>The name of a configuration set.</p> <p> <i>Configuration sets</i> 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.</p>
  - `TrackingOptions` object — <p>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.</p> <p>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.</p>
    - `CustomRedirectDomain` string — The domain to use for tracking open and click events.
  - `DeliveryOptions` object — Used to associate a configuration set with a dedicated IP pool.
    - `TlsPolicy` 'REQUIRE' | 'OPTIONAL' — Specifies whether messages that use the configuration set are required to use Transport Layer Security (TLS). If the value is <code>Require</code>, messages are only delivered if a TLS connection can be established. If the value is <code>Optional</code>, messages can be delivered in plain text if a TLS connection can't be established.
    - `SendingPoolName` string — The name of the dedicated IP pool to associate with the configuration set.
  - `ReputationOptions` object — Enable or disable collection of reputation metrics for emails that you send using this configuration set in the current Amazon Web Services Region.
    - `ReputationMetricsEnabled` boolean — If <code>true</code>, tracking of reputation metrics is enabled for the configuration set. If <code>false</code>, tracking of reputation metrics is disabled for the configuration set.
    - `LastFreshStart` string, date-time — The date and time (in Unix time) when the reputation metrics were last given a fresh start. When your account is given a fresh start, your reputation metrics are calculated starting from the date of the fresh start.
  - `SendingOptions` object — Used to enable or disable email sending for messages that use this configuration set in the current Amazon Web Services Region.
    - `SendingEnabled` boolean — If <code>true</code>, email sending is enabled for the configuration set. If <code>false</code>, email sending is disabled for the configuration set.
  - `Tags` Tag[] — An array of objects that define the tags (keys and values) to associate with the configuration set.
    - `Key` string, required — One part of a key-value pair that defines a tag. The maximum length of a tag key is 128 characters. The minimum length is 1 character.
    - `Value` string, required — The optional part of a key-value pair that defines a tag. The maximum length of a tag value is 256 characters. The minimum length is 0 characters. If you don't want a resource to have a specific tag value, don't specify a value for this parameter. If you don't specify a value, Amazon SES sets the value to an empty string.
  - `SuppressionOptions` object — An object that contains information about the suppression list preferences for your account.
    - `SuppressedReasons` SuppressionListReason[] — <p>A list that contains the reasons that email addresses are automatically added to the suppression list for your account. This list can contain any or all of the following:</p> <ul> <li> <p> <code>COMPLAINT</code> – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a complaint.</p> </li> <li> <p> <code>BOUNCE</code> – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a hard bounce.</p> </li> </ul>
  - `VdmOptions` object — An object that defines the VDM settings that apply to emails that you send using the configuration set.
    - `DashboardOptions` object — Specifies additional settings for your VDM configuration as applicable to the Dashboard.
      - `EngagementMetrics` 'ENABLED' | 'DISABLED' — <p>Specifies the status of your VDM engagement metrics collection. Can be one of the following:</p> <ul> <li> <p> <code>ENABLED</code> – Amazon SES enables engagement metrics for the configuration set.</p> </li> <li> <p> <code>DISABLED</code> – Amazon SES disables engagement metrics for the configuration set.</p> </li> </ul>
    - `GuardianOptions` object — Specifies additional settings for your VDM configuration as applicable to the Guardian.
      - `OptimizedSharedDelivery` 'ENABLED' | 'DISABLED' — <p>Specifies the status of your VDM optimized shared delivery. Can be one of the following:</p> <ul> <li> <p> <code>ENABLED</code> – Amazon SES enables optimized shared delivery for the configuration set.</p> </li> <li> <p> <code>DISABLED</code> – Amazon SES disables optimized shared delivery for the configuration set.</p> </li> </ul>

## Response `200`

Success

- CreateConfigurationSetResponse — An HTTP 200 response if the request succeeds, or an error message if the request fails.

## Other responses

- `480` — AlreadyExistsException
- `481` — NotFoundException
- `482` — TooManyRequestsException
- `483` — LimitExceededException
- `484` — BadRequestException
- `485` — ConcurrentModificationException

---

[API](https://skmtc.net/aws/apis/sesv2.md) · [All operations](https://skmtc.net/aws/apis/sesv2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/sesv2/versions/25eba06e7f64/schema)