Skip to main content
POST
/
v1
/
subscriber_list
Create a List
curl --request POST \
  --url https://hub.suprsend.com/v1/subscriber_list/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "list_id": "_list_id_",
  "list_name": "_list_name_",
  "list_description": "_some sample description_"
}
'
{
  "list_id": "product_updates",
  "list_name": "Product Update",
  "list_description": "Users subscribed to the newsletter",
  "list_type": "static_list",
  "subscribers_count": 3,
  "source": "database_sync",
  "is_readonly": false,
  "status": "active",
  "track_user_entry": false,
  "track_user_exit": false,
  "requested_for_delete": false,
  "created_at": "2024-02-21T19:10:01.906000Z",
  "updated_at": "2025-04-04T07:25:43.186475Z",
  "drafts": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.suprsend.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Pass as Bearer <API_KEY>. Get API Key from SuprSend dashboard Developers -> API Keys section.

Body

application/json
​
list_id
string
default:_list_id_
required

Unique string identifier of the list. Add an id which defines the type of users who are part of the list

​
list_name
string
default:_list_name_

Name of the List. Add a name which defines the type of users in the list

​
list_description
string
default:_some sample description_

Response

201

​
list_id
string
Example:

"product_updates"

​
list_name
string
Example:

"Product Update"

​
list_description
string
Example:

"Users subscribed to the newsletter"

​
list_type
enum<string>
Available options:
static_list,
query_based
​
subscribers_count
integer

number of users in the list

​
source
string

source info on how the list is updated

Example:

"database_sync"

​
is_readonly
boolean
Example:

false

​
status
string
Example:

"active"

​
track_user_entry
boolean

Event $USER_ENTERED_LIST - <list_id> is generated when user is added this list. Use this to trigger workflow on user entry.

​
track_user_exit
boolean

Event $USER_EXITED_LIST - <list_id> is generated when user is removed from this list. Use this to trigger workflow on user exit.

​
requested_for_delete
boolean
Example:

false

​
created_at
string<date-time>
Example:

"2024-02-21T19:10:01.906000Z"

​
updated_at
string<date-time>
Example:

"2025-04-04T07:25:43.186475Z"

​
drafts
string | null

would show the draft list created to replace list users.