v1

latestOpenAPI 3.0.02026-07-244771176.5 KB

Contacts & Lists

Add List

Create New Contact List

post/add-list.json

Response

Successful response

idstring

A unique identifier for the list.

namestring

Custom field name. Firstname and lastname are created by default. There can be up to 10 extra custom fields. 'n' is an integer between 1 and 10.

createdstring date-time

Date and time list was created. Returned in ISO8601 format YYYY-MM-DD HH:MM:SS in UTC Timezone.

members_activeinteger

Number of active members in the list. Always returns 0 for a new list.

fieldsstring[]

Names of created custom fields.

Example response

{
  "name": "email",
  "created": "2024-04-23T12:34:56Z",
  "fields": [
    "email",
    "phone"
  ],
  "errors": [
    {
      "CODE": "MISSING_PARAM",
      "HEADER": 400,
      "DESCRIPTION": "Field parameter is missing (eg. field_n)"
    }
  ]
}