---
title: "PUT /v2/email/configuration-sets/{ConfigurationSetName}/vdm-options"
method: PUT
path: "/v2/email/configuration-sets/{ConfigurationSetName}/vdm-options"
---

# PUT /v2/email/configuration-sets/{ConfigurationSetName}/vdm-options

`PUT /v2/email/configuration-sets/{ConfigurationSetName}/vdm-options`

Specify VDM preferences for email that you send using the configuration set.

You can execute this operation no more than once per second.

## Path parameters

- `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>

## Request body

- object
  - `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

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

## Other responses

- `480` — NotFoundException
- `481` — TooManyRequestsException
- `482` — BadRequestException

---

[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)