# ConfigurationSetProps

Properties for a configuration set.

Extends: ConfigurationSetProps
Used as props by: ConfigurationSet

- Source: [`aws-ses/lib/configuration-set.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-ses/lib/configuration-set.ts#L28)
- Type last changed: v2.254.0 · 13 May 2026

## Example

```ts
new ses.ConfigurationSet(this, 'ConfigurationSet', {
  customTrackingRedirectDomain: 'track.cdk.dev',
  customTrackingHttpsPolicy: ses.HttpsPolicy.REQUIRE,
});
```

## Properties

- `autoValidationThreshold`: [AutoValidationThreshold](/cdk/api/v2/docs/aws-cdk-lib.aws_ses.AutoValidationThreshold.html) — The Auto Validation threshold for this configuration set.

  **Default:** inherit the account-level Auto Validation settings

  When set, Auto Validation is enabled for this configuration set with the specified
  confidence threshold. Cannot be combined with `disableAutoValidation: true`.

- `configurationSetName`: string — A name for the configuration set.

  **Default:** a CloudFormation generated name

- `customTrackingHttpsPolicy`: [HttpsPolicy](/cdk/api/v2/docs/aws-cdk-lib.aws_ses.HttpsPolicy.html) — The https policy to use for tracking open and click events.

  **Default:** HttpsPolicy.OPTIONAL if customTrackingRedirectDomain is set, otherwise undefined

- `customTrackingRedirectDomain`: string — The custom subdomain that is used to redirect email recipients to the Amazon SES event tracking domain.

  **Default:** use the default awstrack.me domain

- `dedicatedIpPool`: [IDedicatedIpPoolRef](/cdk/api/v2/docs/aws-cdk-lib.interfaces.aws_ses.IDedicatedIpPoolRef.html) — The dedicated IP pool to associate with the configuration set.

  **Default:** do not use a dedicated IP pool

- `disableAutoValidation`: boolean — Override the account-level Auto Validation setting for this configuration set.

  **Default:** inherit the account-level Auto Validation settings when autoValidationThreshold is also unspecified

  - `true`: explicitly disable Auto Validation for this configuration set.
    Cannot be combined with `autoValidationThreshold`.
  - `false`: explicitly enable Auto Validation for this configuration set even if
    it is disabled at the account level. The threshold falls back to the SES default
    unless `autoValidationThreshold` is also specified.
  - `undefined`: inherit the account-level setting when `autoValidationThreshold` is also not specified.

- `disableSuppressionList`: boolean = false — If true, account-level suppression list is disabled;

  email sent with this configuration set
  will not use any suppression settings at all

- `maxDeliveryDuration`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The maximum amount of time that Amazon SES API v2 will attempt delivery of email.

  **Default:** undefined - SES defaults to 14 hours

  This value must be greater than or equal to 5 minutes and less than or equal to 14 hours.

- `reputationMetrics`: boolean = true — Whether to publish reputation metrics for the configuration set, such as bounce and complaint rates, to Amazon CloudWatch.

- `sendingEnabled`: boolean = true — Whether email sending is enabled.

- `suppressionReasons`: [SuppressionReasons](/cdk/api/v2/docs/aws-cdk-lib.aws_ses.SuppressionReasons.html) — The reasons for which recipient email addresses should be automatically added to your account's suppression list.

  **Default:** use account level settings

- `tlsPolicy`: [ConfigurationSetTlsPolicy](/cdk/api/v2/docs/aws-cdk-lib.aws_ses.ConfigurationSetTlsPolicy.html) — Specifies whether messages that use the configuration set are required to use Transport Layer Security (TLS).

  **Default:** ConfigurationSetTlsPolicy.OPTIONAL

- `vdmOptions`: [VdmOptions](/cdk/api/v2/docs/aws-cdk-lib.aws_ses.VdmOptions.html) — The Virtual Deliverability Manager (VDM) options that apply to the configuration set.

  **Default:** VDM options not configured at the configuration set level. In this case, use account level settings. (To set the account level settings using CDK, use the `VdmAttributes` Construct.)
