Postman collection
An unofficial Postman collection with one request for every operation in this reference, generated from the same Adobe specifications, and a credential-free environment template for your instance’s settings.
CollectionPostman Collection Format v2.1. 1.2 MB.
Download the collectionEnvironment templateInstance settings and credentials blank; Adobe's public Data Ingestion API host preconfigured.
Download the environment templateGet started
- In Postman, select Import and import both files.
- Select the Marketo Engage (template) environment and set
marketoBaseUrl(your REST API endpoint, such ashttps://<your-instance>.mktorest.com, without/rest),clientIdandclientSecret. For the Data Ingestion API, also setmunchkinId. Enter them as current values so that they stay on your device. - Send Identity API › Identity › GET · Identity. Its post-response script saves the access token and its expiry time in the selected environment.
- Open any other request, fill in its parameters and body, and send it. When the token expires, send the Identity request again.
What to expect
- Requests run only when you send them. The only script saves the token from the Identity requests. Nothing refreshes tokens, retries, chains requests or fetches more pages for you.
- Native Postman requests. Path variables, query parameters, headers and form fields carry the specification’s descriptions. Optional parameters are disabled until you enable them.
- Minimal bodies. JSON bodies contain only the required properties, with
nullwhere you supply a value. Each request’s description lists every documented property and links to its page here. - Manual paging. Request descriptions explain paging parameters such as
nextPageTokenandoffset; you send each page yourself.
Some requests change or delete data
The collection includes every operation, including those that create, update, delete, send or trigger things; their descriptions say so. Don't run the whole collection with the Collection Runner. Use an API user with only the permissions you need, and a sandbox instance when testing.
The collection’s README covers credential storage, how each part of a request is generated, and known limitations.
The collection is not authorised, endorsed or sponsored by Adobe. It is generated from Adobe’s specifications, licensed under the Apache License 2.0; see Notices.