Smart Lists

Smart Lists Endpoint Reference

Marketo offers a set of REST APIs for performing operations on smart lists.  These APIs follow the standard interface pattern for asset APIs providing Query, Delete, and Clone options.

Note: These APIs are supported for user-created Smart Lists only.  They cannot be used for Built-in/System Smart Lists.

 

Query

Querying smart lists follows the standard query types for assets of by id, by name, and browse.

By Id

Query by id takes a single smart list id as a path parameter and returns a single smart list record.  Optionally you may pass the includeRules boolean parameter to include smart list rules in the response.

By Smart Campaign Id

Query by smart campaign id takes a single smart campaign id as a path parameter and returns a single smart list record.  Optionally you may pass the includeRules boolean parameter to include smart list rules in the response.

By Program Id

Query by program id takes a single email program id as a path parameter and returns a single smart list record.  Optionally you may pass the includeRules boolean parameter to include smart list rules in the response.

By Name

Query by name takes a smart list name as a parameter and returns a single smart list record.   An exact string match is performed against all smart list names in the instance, and returns a result for the smart list matching that name.

Browse

Smart lists can also be retrieved in batches.  The folder parameter can be used to specify the parent folder under which the query will be performed and is formatted as a JSON object containing id and type.  Like other bulk asset retrieval endpoints, offset and maxReturn are optional parameters that can be used for for paging.  The optional earliestUpdatedAt and latestUpdatedAt datetime parameters can be used to filter the results by UpdatedAt date range.

Clone

Cloning a smart list is executed with an application/x-www-form-urlencoded POST.  The smart list to clone is specified in the id path parameter.   The folder parameter is used to specify the parent folder under which the smart list will be created and is formatted as a JSON object containing id and type.  Note that the parent folder must be either a Program or a Smart List folder.  The name parameter is used to name the new smart list and must be unique.  Optionally the description parameter may be used to describe the smart list.

Delete

Deleting a smart list takes a single smart list id as a path parameter.