# POST /lists — Create Subscriber List

> Product: **Pabbly Email Marketing** (v2)
> Base URL: `https://emails.pabbly.com/api/v2`
> Auth: Bearer via `Authorization` header
> Canonical: `/email-marketing/subscriber-lists/create-subscriber-list`

Creates a new subscriber list in your account. The list name must be unique (case-insensitive) and cannot conflict with existing segment names. List name must be between 1 and 100 characters.

**Body parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| name | string | Yes | The name of the subscriber list to create (1-100 characters) |

**Example request body:**

```json
{
  "name": "Newsletter Subscribers"
}
```

**Response (201)** — Create Subscriber List:

```json
{
    "success": true,
    "status": "success",
    "message": "Subscriber list created successfully",
    "data": {
        "list": {
            "id": "695ce285efb6f84c1a193d2a",
            "name": "Newsletter Subscribers",
            "count": 0,
            "counts": {
                "totalSubscribers": 0,
                "unsubscribedCount": 0,
                "engagedCount": 0,
                "lastUpdated": "2026-01-06T10:23:01.285Z"
            },
            "createdAt": "2026-01-06T10:23:01.285Z",
            "updatedAt": "2026-01-06T10:23:01.285Z"
        }
    }
}
```

**Code examples:**

_cURL_

```curl
curl -X POST https://emails.pabbly.com/api/v2/lists \
  -H "Authorization: Bearer {{YOUR_API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Newsletter Subscribers"
  }'
```

_Ruby_

```ruby
require 'net/http'
require 'json'

uri = URI('https://emails.pabbly.com/api/v2/lists')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer {{YOUR_API_KEY}}'
request['Content-Type'] = 'application/json'
request.body = "{\"name\":\"Newsletter Subscribers\"}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

data = JSON.parse(response.body)
```

_Python_

```python
import requests

response = requests.post(
    'https://emails.pabbly.com/api/v2/lists',
    headers={'Authorization': 'Bearer {{YOUR_API_KEY}}'},
    json={
    'name': 'Newsletter Subscribers'
},
)

data = response.json()
```

_PHP_

```php
<?php
$ch = curl_init('https://emails.pabbly.com/api/v2/lists');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer {{YOUR_API_KEY}}', 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"name":"Newsletter Subscribers"}');

$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
```

_Java_

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://emails.pabbly.com/api/v2/lists"))
    .header("Authorization", "Bearer {{YOUR_API_KEY}}")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"name\":\"Newsletter Subscribers\"}"));

HttpRequest request = builder.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

_Node.js_

```node
const response = await fetch('https://emails.pabbly.com/api/v2/lists', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {{YOUR_API_KEY}}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Newsletter Subscribers"
  }),
});

const data = await response.json();
```

_Go_

```go
package main

import (
    "fmt"
    "io"
    "net/http"
    "strings"
)

func main() {
    payload := strings.NewReader("{\"name\":\"Newsletter Subscribers\"}")
    req, _ := http.NewRequest("POST", "https://emails.pabbly.com/api/v2/lists", payload)
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer {{YOUR_API_KEY}}")

    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
    fmt.Println(string(body))
}
```

_.NET_

```dotnet
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://emails.pabbly.com/api/v2/lists");
request.Headers.TryAddWithoutValidation("Authorization", "Bearer {{YOUR_API_KEY}}");
request.Content = new StringContent("{\"name\":\"Newsletter Subscribers\"}");
request.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json");

var response = await client.SendAsync(request);
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);
```

---

**Other endpoints in Subscriber Lists:**

- [GET /lists — Get All Subscriber Lists](/email-marketing/subscriber-lists/get-all-subscriber-lists)
- [GET /lists/{{listId}} — Get Single Subscriber List by ID](/email-marketing/subscriber-lists/get-single-subscriber-list-by-id)
- [POST /lists/add-subscriber — Add Subscriber to Lists](/email-marketing/subscriber-lists/add-subscriber-to-lists)
- [POST /lists/remove-subscriber — Remove Subscriber from Lists](/email-marketing/subscriber-lists/remove-subscriber-from-lists)
- [GET /lists — Get Single Subscriber List by List Name](/email-marketing/subscriber-lists/get-single-subscriber-list-by-list-name)
- [POST /lists/move-subscriber — Move Subscriber Between Lists](/email-marketing/subscriber-lists/move-subscriber-between-lists)
- [GET /lists-and-segments — Get all Lists and Segments](/email-marketing/subscriber-lists/get-all-lists-and-segments)