Sign in

v1

latestOpenAPI 3.0.3MIT2026-07-1410794124.7 KB
Lists

Add List

Add a new list. Required Access Level: ModifyContacts

post/lists

Request body

ListNamestring string required

Name of your list.

AllowUnsubscribeboolean

True: Allow unsubscribing from this list. Otherwise, false

Emailsstring[]

Comma delimited list of existing contact emails that should be added to this list. Leave empty for all contacts

Example request

{
  "ListName": "My List 1",
  "Emails": [
    "john.doe@sample.com"
  ]
}

Response

Created

ListNamestring string

Name of your list.

PublicListIDstring guid nullable

ID code of list. Please note that this is different from the listid field.

DateAddedstring date-time

Date of creation in YYYY-MM-DDThh:ii:ss format

AllowUnsubscribeboolean

True: Allow unsubscribing from this list. Otherwise, false

Example response

{
  "ListName": "My List 1",
  "PublicListID": "E33EBA7A-C20D-4D3D-8F2F-5EEF42F58E6F",
  "DateAdded": "2001-01-01T12:00:00"
}