Input and Output of Upsert Leads

When you use the Leads resource, the information in the Input and Output tabs varies depending on the endpoint that you select.

Input and Output for Multiple Leads

If you select the Multiple Leads endpoint, the Input tab contains the following elements:
Input Item Data Type Description
action String Possible values: createOnly, updateOnly, createOrUpdate (default request), and createDuplicate.
lookupField String If specified, the plug-in uses this attribute to find the duplicate. If the lookup field is not specified, the email is used to find the duplicate. If you used other fields, you can select the fields in Field Selector tab and it is shown under the input element, and you can input values.
input Complex An array of lead records that you create or update. The following fields are displayed: email, firstName, and postalCode. If the fields in the Field Selector tab are selected, these fields are added to the input fields.
asyncProcessing Boolean The post processing when calling the creating or updating leads. The default value is false.
partitionName String A lead partition name. If you set up a lead partition in an instance, specify a partition name when you do an upsert call.
The Output tab contains the following elements:
Output Item Data Type Description
requestId String The request ID returned from the Marketo server.
result Complex The fields that are displayed in the response. The following fields are displayed: id, status, and reasons.
success Boolean If the request is successful, this value is true.

Input and Output for Associate

If you select the Associate endpoint, the Input tab contains the following elements:
Input Item Data Type Description
id Integer A known lead ID.
cookie String The cookie value of a lead.
The Output tab contains the following elements :
Output Item Data Type Description
requestId String The request ID returned from the Marketo server.
success Boolean If the request is successful, this value is true.
errors Complex The error codes and messages for the activity.

Input and Output for Merge Leads

If you select the Merge endpoint, the Input tab contains the following elements:
Input Item Data Type Description
id Integer A winning lead ID.
leadIds Complex A separated list of losing lead IDs.
mergeInCRM Boolean Set true to merge in CRM.
The Output tab contains the following elements:
Output Item Data Type Description
requestId String The request ID returned from the Marketo server.
success Boolean If the request is successful, this value is true.
errors Complex The error codes and messages for the activity.