Skip navigation
All Places > Support > Documents
Log in to create and rate content, and to follow, bookmark, and share content with other members.

Munchkin API Troubleshooting

Document created by 08b21bd4b65c4441fd72920f489da6afa097beae on Dec 11, 2014Last modified by 9588451ecc601f1a2620c0a3338f73ddec06dbf4 on Sep 27, 2017
Version 2Show Document
  • View in full screen mode

Note: Please ensure that you have access to an experienced JavaScript developer, because Marketo Technical Support is not set up to assist with troubleshooting custom JavaScript.

If you're trying to use the Munchkin API but not having any success, try these tips:


Include the Munchkin JS


Make sure you include the required lines of Munchkin Javascript on pages with API calls.  You can find the javascript in the Admin section under Munchkin Setup.

Check "Enable Munchkin API"


In the Munchkin Setup page, check the box that says Enable Munchkin API, put in a private key (which can be any text), and click Save.


Look for JavaScript errors


Use Firebug on Firefox or enable IE JavaScript debugging to check for JavaScript errors.  Any JavaScript errors that occur -- anywhere on the page -- could prevent Munchkin from working.


Escape special characters


Check and make sure that any quotation marks or other characters that require escaping are properly escaped.  See this document for more.


Call mktoMunchkin first


In your Javascript, you must call mktoMunchkin() before you use any other Munchkin API calls.


Try a proxy program


Use a web traffic capturing program like Firebug (for Firefox) or Fiddler.  The return code from the API call may have useful information to help you diagnose the issue.



Click Link or visit WebPage isn't working


Check to make sure you have only a path listed in the url parameter -- no ", no domain, and no URL parameters.


Associate Lead isn't working


This could be caused by a few issues:


Include an email address


Email address is required when using the associate Lead call.  If you don't use this, the call will always fail.


Check the labels


Marketo expects the labels (like "Email" and "FirstName") in a specific format.  You can get these labels in the Field Management page of the Admin section.  When you get there, click the Export Fields button.  The spreadsheet will have the API names for your fields.


Check the hash value


The hash value is the SHA1 hash (non-HMAC version) of your API Private Key (not your Munchkin ID) concatenated with the lead's email address, as in  The hash value must be lowercase.