> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecomail.cz/llms.txt
> Use this file to discover all available pages before exploring further.

# Add new list

> Create a new subscriber list in your account.

<ParamField body="name" type="string" required>
  List name.
</ParamField>

<ParamField body="from_name" type="string">
  Sender name used in emails sent from this list.
</ParamField>

<ParamField body="from_email" type="string">
  Sender email address used in emails sent from this list.
</ParamField>

<ParamField body="reply_to" type="string">
  Reply-to email address.
</ParamField>

<ParamField body="sub_success_page" type="string">
  URL to redirect to after submitting a sign-up form.
</ParamField>

<ParamField body="sub_confirmed_page" type="string">
  URL to redirect to after confirming a sign-up email.
</ParamField>

<ParamField body="unsub_page" type="string">
  URL to redirect to after unsubscribing from the list.
</ParamField>

<ParamField body="double_optin" type="boolean">
  Whether sign-up confirmation (double opt-in) is required.
</ParamField>

<ParamField body="conf_subject" type="string">
  Subject line of the confirmation email.
</ParamField>

<ParamField body="conf_message" type="string">
  HTML content of the confirmation email.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api2.ecomailapp.cz/lists \
    -H "key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "New list name",
      "from_name": "Ecomailapp.cz",
      "from_email": "test@ecomailapp.cz",
      "reply_to": "support@ecomail.cz"
    }'
  ```

  ```php PHP theme={null}
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, 'https://api2.ecomailapp.cz/lists');
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_POST, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'key: YOUR_API_KEY',
      'Content-Type: application/json',
  ]);
  curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
      'name' => 'New list name',
      'from_name' => 'Ecomailapp.cz',
      'from_email' => 'test@ecomailapp.cz',
      'reply_to' => 'support@ecomail.cz',
  ]));
  $response = curl_exec($ch);
  curl_close($ch);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "name": "New list name",
    "id": 2
  }
  ```
</ResponseExample>