Static Lists

Static Lists Endpoint Reference

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

Query

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

By Id

Query by id takes a single static list id as a path parameter and returns a single static list record.

By Name

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

Browse

Static 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 earliestUpdatedAt and latestUpdatedAt parameters allow you to set low and high datetime watermarks for returning static lists created or updated within the given range.  Datetime values must be valid ISO-8601 strings, and should not include milliseconds

Create and Update

Creating a static list is executed with an application/x-www-form-urlencoded POST with two required parameters.  The folder parameter is used to specify the parent folder under which the static list will be created and is formatted as a JSON object containing id and type.  The name parameter is used to name the static list and must be unique.  Optionally the description parameter may be used to describe the  static list.

Updates to a static list are made through a separate endpoint with two optional parameters.  The description parameter may be used to update the static list descriptionThe name parameter may be used to update the static list name and must be unique.

Delete

Deleting a static list takes a single static list id as a path parameter.  Deletions cannot be made to static lists that are in use by an import or export operation, or are in use by other assets.