Subscription Lists


Fetch Subscription Lists

Return json data about subscription lists

URL

/subscription_lists

Method

GET

Success Response

Code:200
Content:

{
"data": [
{
"id": "string",
"type": "subscription_list",
"attributes": {
"name": "string",
"is_default": "bool",
"subscriber_count": "number"
}
}
]
}

Create Subscription List

Creates a subscription list record

URL

/subscription_lists

Method

POST

Data Params

{
"subscription_list": {
"name": "string" // can't be == 'default'
}
}

Success Response

Code: 200
Content:

{
"data": {
"id": "string",
"type": "subscription_list",
"attributes": {
"name": "string",
"is_default": false,
"subscriber_count": 0
}
}
}

Update Subscription List

Updates a subscription list record

URL

/subscription_lists/:subscription_list_id

Method

PATCH | PUT

Data Params

{
"subscription_list": {
"name": "string"
}
}

Success Response

Code: 200
Content:

{
"data": {
"id": "string",
"type": "subscription_list",
"attributes": {
"name": "string",
"is_default": false,
"subscriber_count": "number"
}
}
}

Delete Subscription List

Deletes subscription list record

Can not delete default/all contacts list

URL

/subscription_lists/:subscription_list_id

Method

DELETE

Success Response:

Code: 200
Content:

{}