---
title: "PUT /v2/email/contact-lists/{ContactListName}"
method: PUT
path: "/v2/email/contact-lists/{ContactListName}"
---

# PUT /v2/email/contact-lists/{ContactListName}

`PUT /v2/email/contact-lists/{ContactListName}`

Updates contact list metadata. This operation does a complete replacement.

## Path parameters

- `ContactListName` string, required

## Request body

- object
  - `Topics` Topic[] — An interest group, theme, or label within a list. A contact list can have multiple topics.
    - `TopicName` string, required — The name of the topic.
    - `DisplayName` string, required — The name of the topic the contact will see.
    - `Description` string — A description of what the topic is about, which the contact will see.
    - `DefaultSubscriptionStatus` 'OPT_IN' | 'OPT_OUT', required — The default subscription status to be applied to a contact if the contact has not noted their preference for subscribing to a topic.
  - `Description` string — A description of what the contact list is about.

## Response `200`

Success

- UpdateContactListResponse

## Other responses

- `480` — BadRequestException
- `481` — TooManyRequestsException
- `482` — NotFoundException
- `483` — 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)