Note: This post will be updated to reflect changes made to activity records returned by the API due to migration to new infrastructure.
Last Update: September 13, 2018
With the rollout of Marketo’s next-generation Activity Service beginning in September 2017, we will be unable to enforce the uniqueness or presence of the integer “id” field in activities, data value changes, or lead deletion records returned by Marketo’s APIs.
To avoid service disruptions for integrations which retrieve activity records, the id field should be treated as optional. Cutover of this change will begin to affect subscriptions and upcoming release.
This change will affect the following endpoints:
REST API
SOAP API
The affected SOAP types are ActivityRecord and LeadChangeRecord.
Examples
The following examples show record types which will be affected. In both examples, the effected field is called “id.”
Example REST Field: id
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 |
{ "id" : 102988, "leadId" : 1, "activityDate" : "2015-01-16T23:32:19Z", "activityTypeId" : 1, "primaryAttributeValueId" : 71, "primaryAttributeValue" : "localhost/munchkintest2.html", "attributes" : [ { "name" : "Client IP Address", "value" : "10.0.19.252" }, { "name" : "Query Parameters", "value" : "" }, { "name" : "Referrer URL", "value" : "" }, { "name" : "User Agent", "value" : "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/39.0.2171.95 Safari/537.36" }, { "name" : "Webpage URL", "value" : "/munchkintest2.html" } ] } |
Example SOAP Field: id
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
<activityRecord> <id>1030680</id> <activityDateTime>2013-07-09T16:44:28-05:00</activityDateTime> <activityType>Visit Webpage</activityType> <mktgAssetName>ClickDemo</mktgAssetName> <activityAttributes> <attribute> <attrName>Webpage ID</attrName> <attrType xsi:nil="true" /> <attrValue>2547</attrValue> </attribute> <attribute> <attrName>Webpage URL</attrName> <attrType xsi:nil="true" /> <attrValue>/ClickDemo.html</attrValue> </attribute> </activityAttributes> <campaign /> <personName xsi:nil="true" /> <mktPersonId>1089965</mktPersonId> <foreignSysId xsi:nil="true" /> <orgName xsi:nil="true" /> <foreignSysOrgId xsi:nil="true" /> </activityRecord> |
FAQs
Yes. The marketoGUID field will only be returned in activities when using the WSDL version 3.1 or later. The new URI will follow this pattern: https://{munchkinId}.mktoapi.com/soap/mktows/3_1 It may also be obtained through the Admin->Web Services menu in your subscription
Beginning with our Q1 Minor Release on April 7th 2017, activity records retrieved via Marketo’s SOAP or REST APIs will include a new field called “marketoGUID”. The value of this field will match the value of the “id” field, but will be a string type field. Some time after the Q2 2018 release, the “id” field will stop being returned as part of these records, and the value of marketoGUID will become a 128-character string.
If you are responsible for code that deals with Marketo activities, you should determine whether your code relies on the presence or uniqueness of “id” field for Marketo activities, and then remove that requirement. In an upcoming release, an additional string field called “marketoGUID” will be added. “marketoGUID” should be considered the unique ID for retrieved activities when it becomes available. If you are not, you should consult with your team and relay this message to the appropriate stakeholders.
This change should only affect client and partner integrations which retrieve activity records from Marketo, and only if the integrations rely on either the presence and/or type of the “id” field in the response, or rely on the uniqueness of the field. After the rollout of Orion AS, and the disabling of activity writes to MySQL, the “id” field will no longer be available and will be supplanted by a unique string id field.