Marketo - Upsert object action

This action creates or updates an object in Marketo.

Input

FieldDescription
ObjectThe type of object to upsert.

Refer to the relevant sections to learn how to configure the input fields for the object you plan to upsert:

Lead input fields

FieldDescription
Lookup field (dedup)This field is used to identify unique records. Options include Cookies, Email address, Marketo Social Twitter ID, Marketo Social Facebook ID, Marketo Social LinkedIn ID, SFDC Account ID, SFDC Contact ID, SFDC Lead ID, and SFDC Lead Owner ID.
Lead fieldsExpand to configure the fields associated with the lead for the upsert action.

Refer to the Marketo documentation for a list of standard fields available through the API. This list includes common fields but may not cover all input fields specific to this action.

Opportunity input fields

FieldDescription
Opportunity fieldsExpand to configure the fields associated with the opportunity for the upsert action.
External opportunity IDProvide the unique ID for the opportunity in an external system.
External opportunity campaign IDEnter the campaign ID associated with the opportunity from an external source.
AmountFill in the total amount for the opportunity.
Close dateEnter the date when the opportunity is expected to close.
DescriptionProvide a brief description of the opportunity.
Expected revenueFill in the estimated revenue expected from the opportunity.
External company IDEnter the external ID for the company associated with this opportunity.
External created dateProvide the date when the opportunity was created in an external system.
External sales person IDEnter the ID of the salesperson from an external system.
FiscalSpecify the fiscal period for this opportunity.
Fiscal quarterProvide the fiscal quarter when this opportunity falls.
Fiscal yearEnter the fiscal year for the opportunity.
Forecast categorySpecify the forecast category for this opportunity.
Forecast category nameEnter the name of the forecast category for the opportunity.
Is closedIndicate whether the opportunity is closed.
Is wonIndicate whether the opportunity has been won.
Last activity dateProvide the date of the last activity related to this opportunity.
Lead sourceEnter the source from which the lead originated.
NameFill in the name of the opportunity.
Next stepProvide details about the next step for this opportunity.
ProbabilityEnter the probability of winning this opportunity (as a percentage).
QuantitySpecify the quantity of items or services in the opportunity.
StageProvide the current stage of the opportunity.
TypeEnter the type or classification of the opportunity.

Opportunity role input fields

FieldDescription
Opportunity role fieldsExpand to configure the fields associated with the opportunity role for the upsert action.
External opportunity IDThe unique identifier for the opportunity from an external system.
Lead IDThe unique identifier for the lead associated with the opportunity role.
RoleThe role of the lead in the opportunity.
External contact IDThe unique identifier for the contact from an external system.
External IDA general external identifier for the opportunity role, if applicable.
External created dateThe date when the opportunity role was created in the external system.
Is primaryIndicates whether this role is the primary role for the opportunity.

Custom object input fields

FieldDescription
Custom object / Custom object nameSelect a custom object name from the list, or enter a custom object name with the suffix _c.
Custom object fieldsExpand to configure the fields associated with the custom object for the upsert action.

Output

The output fields vary depending on the object you select for the action.

Lead output fields

FieldDescription
Marketo GUIDThe unique identifier assigned to the lead in Marketo.

Opportunity output fields

FieldDescription
Marketo GUIDThe unique identifier assigned to the opportunity in Marketo.

Opportunity role output fields

FieldDescription
Marketo GUIDThe unique identifier assigned to the opportunity role in Marketo.

Custom object output fields

FieldDescription
Marketo GUIDThe unique identifier assigned to the custom object in Marketo.

Last updated: