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.

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.

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.

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.  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.