---
title: "POST /v2/email/contact-lists"
method: POST
path: "/v2/email/contact-lists"
---

# POST /v2/email/contact-lists

`POST /v2/email/contact-lists`

Creates a contact list.

## Request body

- object
  - `ContactListName` string, required — The name of the contact list.
  - `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.
  - `Tags` Tag[] — The tags associated with a contact list.
    - `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.

## Response `200`

Success

- CreateContactListResponse

## Other responses

- `480` — BadRequestException
- `481` — TooManyRequestsException
- `482` — AlreadyExistsException
- `483` — LimitExceededException

---

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