Marketo API

Getting access, Developing, Testing

Back to Marketo

Get Lead Changes

Returns a list of Data Value Changes and New Lead activities after a given datetime. Required Permissions: Read-Only Activity, Read-Write Activity

Input

type: object properties: parameters: type: object properties: nextPageToken: type: string description: >- Token representation of a datetime returned by the Get Paging Token endpoint. This endpoint will return activities after this datetime fields: type: array items: type: string description: >- Comma-separated list of field names to return changes for. Field names can be retrieved with the Describe Lead API. listId: type: integer format: int32 description: >- Id of a static list. If set, will only return activities of members of this static list. leadIds: type: array items: type: integer format: int64 description: >- Comma-separated list of lead ids. If set, will only return activities of the leads with these ids. Allows up to 30 entries. batchSize: type: integer format: int32 description: Maximum number of records to return. Maximum and default is 300. required: - nextPageToken - fields title: Parameters

Output

required: - errors - requestId - result - success - warnings type: object properties: errors: type: array description: Array of errors that occurred if the request was unsuccessful items: required: - code - message type: object properties: code: type: string description: >- Error code of the error. See full list of error codes <a href="https://developers.marketo.com/rest-api/error-codes/">here</a> message: type: string description: Message describing the cause of the error moreResult: type: boolean description: Boolean indicating if there are more results in subsequent pages example: false nextPageToken: type: string description: Paging token given if the result set exceeded the allowed batch size requestId: type: string description: Id of the request made result: type: array description: Array of results for individual records in the operation, may be empty items: required: - activityDate - activityTypeId - attributes - id - leadId type: object properties: activityDate: type: string description: Datetime of the activity format: date-time activityTypeId: type: integer description: Id of the activity type format: int32 attributes: type: array description: List of secondary attributes items: required: - name - value type: object description: Name-Value pair properties: apiName: type: string name: type: string description: Name of the attribute value: type: object description: Value of the attribute campaignId: type: integer format: int64 fields: type: array items: required: - id - name - newValue type: object description: Activity record containing information on a data value change properties: id: type: integer description: Unique integer id of the change record format: int32 name: type: string description: Name of the field which was changed newValue: type: string description: New value after the change oldValue: type: string description: Old value before the change id: type: integer description: >- Integer id of the activity. For instances which have been migrated to Activity Service, this field may not be present, and should not be treated as unique. format: int64 leadId: type: integer description: Id of the lead associated to the activity format: int64 marketoGUID: type: string description: Unique id of the activity (128 character string) success: type: boolean description: Whether the request succeeded example: false warnings: type: array description: Array of warnings given for the operation items: required: - code - message type: object properties: code: type: integer description: Integer code of the warning format: int32 message: type: string description: Message describing the warning