marketo op get activities

Get Marketo Activities

Version: 17.07

Supported Since: 17.07

Get Marketo Activities connector operation provides the facilities to fetch Marketo Activities related information. This connector operation provides the following sub operations.

All these operations require Read-Only Activity or Read-Write Activity permissions from Marketo API.

Get Activity List

Get Activity List operation can be used to a get a list of activities from after a datetime given by the nextPageToken parameter.

Parameters

* marked fields are mandatory

Next page token *

Basic

Token representation of a datetime returned by the Get Activity Paging Token operation. This operation will return activities after this datetime. This can be specified as a constant value or as a combination of placeholder expressions.

Activity Type IDs *

Basic

A Comma-separated list of activity type IDs (as Integers) that can be retrieved with the Get Activity Types operation. This can be specified as a constant value or as a combination of placeholder expressions.

Asset IDs

Basic

A Comma-separated list of primary asset IDs (as Integers) for activities. This is based on the primary asset ID of a given activity type and should only be used when a single activity type is set. This can be specified as a constant value or as a combination of placeholder expressions.

Filter type

Basic

The type to filter to be applied to the Activities list. By default no filters are applied.

  1. Filter By Lead List - Filter the activities by the members of a static list

  2. Filter By Lead IDs - Filter the activities by the Leads with the given IDs

Lead list ID *

Basic

This parameter is only applicable if Filter type parameter is set to Filter By Lead List.

ID of a Lead list to filter Activities from. If set, this will only return activities of the members of this static list. This can be specified as a constant value or as a combination of placeholder expressions.

Lead IDs *

Basic

This parameter is only applicable if Filter type parameter is set to Filter By Lead IDs.

A Comma-separated list of Lead IDs (as Integers) for activities. If set, this will only return activities of the leads with these IDs. This list can contain maximum of 30 entries and can be specified as a constant value or as a combination of placeholder expressions.

Batch Size

Basic

The size of the batch to return. The maximum and default value is 300.

Response

If this operation was invoked successfully, it will provide a response message with a JSON payload of the following format.

{
  "errors": [
    {
      "code": 0,
      "message": "string"
    }
  ],
  "moreResult": false,
  "nextPageToken": "string",
  "requestId": "string",
  "result": [
    {
      "activityDate": "2017-10-30T07:24:30.823Z",
      "activityTypeId": 0,
      "attributes": [
        {
          "apiName": "string",
          "name": "string",
          "value": {}
        }
      ],
      "campaignId": 0,
      "id": 0,
      "leadId": 0,
      "marketoGUID": "string",
      "primaryAttributeValue": "string",
      "primaryAttributeValueId": 0
    }
  ],
  "success": false,
  "warnings": [
    {
      "code": 0,
      "message": "string"
    }
  ]
}

Get Lead Deletion Activities

Get Lead Deletion Activities operation can be used to a get a list of leads deleted after a given datetime. Deletions greater than 30 days old may be pruned.

Parameters

* marked fields are mandatory

Next page token *

Basic

Token representation of a datetime returned by the Get Activity Paging Token operation. This operation will return activities after this datetime. This can be specified as a constant value or as a combination of placeholder expressions.

Batch Size

Basic

The size of the batch to return. The maximum and default value is 300.

Response

If this operation was invoked successfully, it will provide a response message with a JSON payload of the following format.

{
  "errors": [
    {
      "code": 0,
      "message": "string"
    }
  ],
  "moreResult": false,
  "nextPageToken": "string",
  "requestId": "string",
  "result": [
    {
      "activityDate": "2017-10-30T07:24:30.833Z",
      "activityTypeId": 0,
      "attributes": [
        {
          "apiName": "string",
          "name": "string",
          "value": {}
        }
      ],
      "campaignId": 0,
      "id": 0,
      "leadId": 0,
      "marketoGUID": "string",
      "primaryAttributeValue": "string",
      "primaryAttributeValueId": 0
    }
  ],
  "success": false,
  "warnings": [
    {
      "code": 0,
      "message": "string"
    }
  ]
}

Get Lead Changes Activities

Get Lead Changes Activities operation can be used to a get a list of Data Value Changes and New Lead activities after a given datetime.

Parameters

* marked fields are mandatory

Next page token *

Basic

Token representation of a datetime returned by the Get Activity Paging Token operation. This operation will return activities after this datetime. This can be specified as a constant value or as a combination of placeholder expressions.

Fields *

Basic

A Comma-separated list of field names to return changes for. This can be specified as a constant value or as a combination of placeholder expressions.

Filter type

Basic

The type to filter to be applied to the Activities list. By default no filters are applied.

  1. Filter By Lead List - Filter the activities by the members of a static list

  2. Filter By Lead IDs - Filter the activities by the Leads with the given IDs

Lead list ID *

Basic

This parameter is only applicable if Filter type parameter is set to Filter By Lead List.

ID of a Lead list to filter Activities from. If set, this will only return activities of the members of this static list. This can be specified as a constant value or as a combination of placeholder expressions.

Lead IDs *

Basic

This parameter is only applicable if Filter type parameter is set to Filter By Lead IDs.

A Comma-separated list of Lead IDs (as Integers) for activities. If set, this will only return activities of the leads with these IDs. This list can contain maximum of 30 entries and can be specified as a constant value or as a combination of placeholder expressions.

Batch Size

Basic

The size of the batch to return. The maximum and default value is 300.

Response

If this operation was invoked successfully, it will provide a response message with a JSON payload of the following format.

{
  "errors": [
    {
      "code": 0,
      "message": "string"
    }
  ],
  "moreResult": false,
  "nextPageToken": "string",
  "requestId": "string",
  "result": [
    {
      "activityDate": "2017-10-30T07:24:30.843Z",
      "activityTypeId": 0,
      "attributes": [
        {
          "apiName": "string",
          "name": "string",
          "value": {}
        }
      ],
      "campaignId": 0,
      "fields": [
        {
          "id": 0,
          "name": "string",
          "newValue": "string",
          "oldValue": "string"
        }
      ],
      "id": 0,
      "leadId": 0,
      "marketoGUID": "string"
    }
  ],
  "success": false,
  "warnings": [
    {
      "code": 0,
      "message": "string"
    }
  ]
}
In this topic
In this topic
Contact Us