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

# POST /v1/email/configuration-sets

`POST /v1/email/configuration-sets`

Create a configuration set. <i>Configuration sets</i> are groups of rules that you can apply to the emails you send using Amazon Pinpoint. 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.

## Request body

- object
  - `ConfigurationSetName` string, required — <p>The name of a configuration set.</p> <p>In Amazon Pinpoint, <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 Amazon Pinpoint 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 AWS. You can optionally configure Amazon Pinpoint to use a domain that you operate for these images and links.</p>
    - `CustomRedirectDomain` string — The domain that you want 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 that you want 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 AWS 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 AWS 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) that you want 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. Amazon Pinpoint will set the value to an empty string.

## 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/pinpoint-email.md) · [All operations](https://skmtc.net/aws/apis/pinpoint-email/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/pinpoint-email/versions/73704a3e0b47/schema)