Back to MarketoGet 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