Marketo uses Swagger to provide a formal definition of the public interface for its REST APIs. Swagger provides a very rich definition model for URL structures, request models, and response models, and has a very developed ecosystem of tools for use with API interaction, testing and client generation.
Using Marketo’s Swagger Definitions
The Swagger standard either requires a host to be provided, or for the host to be generated by the host serving the file, it is important to correct the host in the definition prior to employing any existing tools, as Marketo provides an empty host parameter with the definition. The REST API host for each Marketo instance is unique, and follows the pattern:
The Marketo Asset APIs use application/x-www-url-formencoded style parameters in requests for endpoints which require a POST method. In some cases however, such as folder parameters, the value for the parameter may be a JSON array or object. These parameters are noted in the endpoint reference.