syncCustomObjects

Accepts an array of custom objects to be created or updated, up to a maximum of 100 per call, and returns the outcome (status) of the operation (CREATED, UPDATED, FAILED, UNCHANGED, SKIPPED) and the custom object(s) that were processed. The API can be called in one of three operation modes:

INSERT – only insert new objects, skip existing objects

UPDATE – only update existing objects, skip new objects

UPSERT – insert new objects and update existing objects

In a single API call some updates may succeed and some may fail. An error message will be returned for each failure.

For Custom Objects provisioned with the new Custom Object UI, only fields which are designated as dedupe fields in the UI may be passed as attributes in CustomObjKeyList. Link fields which are not dedupe fields must be passed as an attribute in customObjAttributeList.

Request

Field Name

Required/Optional

Description

operation

Required

“INSERT”, “UPDATE” or “UPSERT”

objectTypeName

Required

Name of the Custom Object

customObjectList->customObject->customObjKeyList->attribute

Required

The attribute is a key/value pair that is used to identify the custom object. You can have multiple attributes in the customObjKeyList

customObjectList->customObject->customObjAttributeList->attribute

Required

Key/value pairs, where the name is the field name and value is the value that you want to insert into the customObject

Latest Blog Posts

Keep up with what's new in the developer world

Important Change to Activity Records in Marketo APIs March 1, 2017 Note: This post will be updated to reflect changes made to activity records returned by the API due to migration to new infrastructure.
With the rollout of Marketo’s next-generation Activity Service beginning in Septmeber, we will be unable to enforce the uniqueness or presence of the integer “id” field in activities, data value changes, or lead deletion ... Read More >

Internet of Things for Marketers with IFTTT and Zapier June 20, 2017 The Internet of Things (IoT) is the inter-networking of connected devices, appliances, wearables, vehicles, etc. with embedded electronics, software, sensors, and network connectivity that enable these objects to collect and exchange data with cloud information systems. These technologies are growing and trending so fast that they will impact how we live, how we work and ... Read More >

Spring 2017 Updates June 16, 2017 In the Spring 2017 release, we are adding the ability to bulk extract lead and activity object data asynchronously, and to manipulate named account lists. See the full list of updates below.
Lead Database APIs
Bulk Extract of Leads
New endpoints to support extraction of leads in bulk. Specify record selection criteria using a variety of options. Details can ... Read More >