Create List

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

Create a new list.

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

Scopes:
list:write

Responses

Language

Credentials

Header


xxxxxxxxxx
16
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: 2023-09-15' \
7
     --data '
8
{
9
  "data": {
10
    "type": "list",
11
    "attributes": {
12
      "name": "Newsletter"
13
    }
14
  }
15
}
16
'


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

201

4XX

5XX