Create List

post https://a.klaviyo.com/api/lists/

Create a new list.

Rate limits:
Burst: 10/s
Steady: 150/m
Daily: 150/d

Scopes:
lists:write

Responses

Language

Credentials

Header


xxxxxxxxxx
13
1
curl --request POST \
2
     --url https://a.klaviyo.com/api/lists/ \
3
     --header 'Authorization: Klaviyo-API-Key your-private-api-key' \
4
     --header 'accept: application/json' \
5
     --header 'content-type: application/json' \
6
     --header 'revision: 2024-07-15' \
7
     --data '
8
{
9
  "data": {
10
    "type": "list"
11
  }
12
}
13
'


xxxxxxxxxx
53
}
1
{
2
  "data": {
3
    "type": "list",
4
    "id": "Y6nRLr",
5
    "attributes": {
6
      "name": "Newsletter",
7
      "created": "2022-11-08T00:00:00+00:00",
8
      "updated": "2022-11-08T00:00:00+00:00",
9
      "opt_in_process": "double_opt_in"
10
    },
11
    "relationships": {
12
      "profiles": {
13
        "data": [
14
          {
15
            "type": "profile",
16
            "id": "string"
17
          }
18
        ],
19
        "links": {
20
          "self": "string",
21
          "related": "string"
22
        }
23
      },
24
      "tags": {
25
        "data": [

201Success

4XXClient Error

5XXServer Error