Skip to main content
POST
/
subscriber-lists
Create a subscriber list
curl --request POST \
  --url https://{domain}/api/site/subscriber-lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "New List"
}
'
{
  "id": 87647751,
  "name": "My list",
  "created": 1613384738,
  "subscribers": 25,
  "opens": 0.85,
  "clicks": 0.41
}

Authorizations

​
Authorization
string
header
required

Pass your API key as: Authorization: Bearer <API KEY>.

Body

application/json
​
name
string
required
Example:

"New List"

Response

200 - application/json

The created subscriber list.

​
id
integer

Unique list id.

Example:

87647751

​
name
string

List name.

Example:

"My list"

​
created
integer<int64>

Timestamp in Unix seconds since epoch.

Example:

1613384738

​
subscribers
integer

Total number of subscribers in this list.

Example:

25

​
opens
number

Open rate (0 to 1).

Example:

0.85

​
clicks
number

Click rate (0 to 1).

Example:

0.41

Last modified on June 20, 2026