Lists are used to keep contacts organised. Lists can be used to do the same action to all the contacts in a list eg. send surveys to everyone in a list. Lists can contain multiple contacts and contacts can be on multiple lists.
Lists object
Attributes:
id string
Unique identifier.
type string
Type of list. Allowed values: customer, employee
count integer
Amount of contacts in the list.
name string
User defined name of the list.
source string (optional)
Source of the list. Smart lists are automatically populated/unpopulated in Trustmary based on survey answers. Allowed values: list, smart (in some legacy lists this will be undefined even if they are of type list)
created_at ISO 8601 with timezone
Time review was created.
updated_at ISO 8601 with timezone
Time of last action performed on the review object.
deleted_at ISO 8601 with timezone or null
If review was deleted, time of the last deletion.
{
"id": "asdv14311",
"type": "customer",
"count": 2165,
"name": "Freemium SaaS users",
"source": "list",
"created_at": "2021-05-01T00:00:00.000Z",
"updated_at": "2021-05-01T00:00:00.000Z",
"deleted_at": null
}
Getting Lists
GET /lists
Body attributes:
type string
Type of lists to retrieve. Allowed values: customer, employee
offset integer (optional)
You will get only first 1000 lists, when you want the next 1000 lists use offset 1000 and so on.
{
"type": "customer"
}
Returning
An array of Lists.