List Management

Use this endpoint to enumerate all of your lists in Engage.

Endpoint and Methods

GET /_rest/v2/lists

Sample Responses

Code 200 Response

Response code 200 returns a collection of list objects.

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
[
{
"listName": "Bob's List",
"listId": "51i8c0edotame81bb4cbf000",
"description": "List of Bob's contacts",
"customerId": 9999999,
"modifiedDate": "2019-06-18T00:14:03Z",
"modifiedBy": "sspeirs",
"createdDate": "2019-06-18T00:14:03Z",
"createdBy": "sspeirs",
"deleteFlag": "false",
"campaignRel": [
"4kk11065jkl0985bb48mf054"
],
"contactRel": [
"4kk11065jkl0985bb48mf054"
]
}
]

Code 401 Response

Response code 401 returns an error that the authorization token is invalid.

Copy

1
2
3
4
{
"message": "string",
"status": 401
}

Code 500 Response

Response code 500 returns an error during the retrieval of lists.

Copy

1
2
3
4
{
"message": "Something went wrong during the retrieval of a customer's lists",
"status": 500
}