Custom Objects

Sync Custom Objects

Upsert (insert or update) a list of custom object records. If a link field to a Person is specified in the request and that Person does not exist, several retries occur. If that Person is added during the retry window (65 minutes), then the update is successful. Required permission: Read-Write Custom Object.

post/subscriptions/{munchkinId}/customobjects/{customObjectAPIName}

Request

  • Base URL: https://mkto-ingestion-api.adobe.io
  • URL: https://mkto-ingestion-api.adobe.io/subscriptions/{munchkinId}/customobjects/{customObjectAPIName}
  • Auth: none declared. Required headers: X-Mkto-User-Token

Path parameters

munchkinIdstring required
Example:556-RJS-213

Marketo subscription Munchkin ID

customObjectAPINamestring required
Example:purchases

The API name of the custom object type

Headers

X-Mkto-User-Tokenstring required

Marketo API access token

X-Correlation-Idstring

Arbitrary string (max 255 characters). Used to trace requests through the system via Marketo Observability Data Stream.

X-Request-Sourcestring

Arbitrary string (max 50 characters). Used to trace the source of requests.

Request body

priority'normal' | 'high'

Priority of the request.

dedupeBy'dedupeFields' | 'marketoGUID'

Attributes to deduplicate on.

customObjectsCustomObject[] required

List of attribute name-value pairs for the object.

Example request

{
  "customObjects": [
    {
      "email": "brooklyn.parker@karnv.com",
      "vin": "20UYA31581L000000",
      "make": "BMW",
      "model": "3-Series 330i",
      "year": 2003
    }
  ]
}

Response

Accepted – request accepted for async processing

Changes

No recorded changes to this operation across all 1 revision of this API.