---
title: "Add new list"
method: POST
path: "/lists"
tags: ["Lists"]
---

# Add new list

`POST /lists`

Create a new subscriber list in your account.

## Request body

- object
  - `name` string, required — List name.
  - `from_name` string — Sender name used in emails sent from this list.
  - `from_email` string — Sender email address used in emails sent from this list.
  - `reply_to` string — Reply-to email address.
  - `sub_success_page` string — URL to redirect to after submitting a sign-up form.
  - `sub_confirmed_page` string — URL to redirect to after confirming a sign-up email.
  - `unsub_page` string — URL to redirect to after unsubscribing from the list.
  - `double_optin` boolean — Whether sign-up confirmation (double opt-in) is required.
  - `conf_subject` string — Subject line of the confirmation email.
  - `conf_message` string — HTML content of the confirmation email.

## Response `200`

OK

- object
  - `name` string
  - `id` integer

---

[API](https://skmtc.dev/ecomail/apis/ecomail-api.md) · [All operations](https://skmtc.dev/ecomail/apis/ecomail-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ecomail/ecomail-api/revisions/31b5789931fe/schema)