Overview

MadKudu offers real-time scoring within Marketo today (see how to set up Marketo with MadKudu).

However, the SLA for the real-time scoring within Marketo today is between 15 to 30 minutes today. The reason for that is that there is a default daily quota of 50,000 API calls per day. Since records are pulled and pushed by batches of 300, this can run out relatively quickly.

However, we understand there are some use cases where you need to have the real-time Customer Fit score pushed to Marketo. The good news is that there is a workaround to set this up but you would. need to set this up within Marketo. 👇

Setup Guide

Disclaimer here is that you should check your daily API quota within Marketo to make sure that you are able to limit the number of Marketo API calls you make. 

1. Create a webhook within Marketo (see Marketo's documentation). 
2. Get your MadKudu API key from the App, under Integrations > API, and copy to clipboard.
3. Use an online Base64 encoding tool such as https://www.base64encode.org/ to encode this key in Base64 format.
4. Paste the result to a customer header on the webhook:
5. Call the MadKudu Persons API by inputting this HTTP request in the `URL` field in Marketo with a GET request: https://api.madkudu.com/v1/persons?email={{lead.EmailAddress:default=}}.  Note : Replace EmailAddress with your Marketo field storing the email of the lead, its name might be different.
6. In the 'Response mapping' section, map the scoring fields on MadKudu's side to the scoring fields you created on Marketo's side. The mapping to do is:

7. MadKudu field	Marketo field (these are the names suggested in the fields creation guide)
   properties.customer_fit.segment	mk_customer_fit_segment
   properties.customer_fit.score	mk_customer_fit_score
   properties.customer_fit.top_signals_formatted	mk_customer_fit_signals

8. Set up a SmartCampaign in Marketo to trigger off person create or update that would call the MadKudu API and pull the data back.
9. Parse and map the call results from within the Marketo Flow Step.
10.  Make the rest of the necessary configurations within Marketo. Example: enter the authorization requirements in the `Template` field. 

Full MadKudu API documentation here.