Lookup actions

Lookup objects

Lookup objects by criteria.

Lookup Objects

List of expected config fields

List contains default object types and custom object types.

Supported default object types:

  • Companies

  • Leads

  • Named accounts

  • Opportunities

  • Opportunity roles

  • Sales persons.

Emit behavior

Options are:

Emit individually

Emits each object in a separate message.

Fetch all

Emits all objects in one message.

Expected input metadata

Input JSON Schema:

json { "type": "object", "properties": { "searchTerm0": { "title": "Search term", "type": "object", "properties": { "filterType": { "title": "Field Name", "type": "string", "required": true }, "filterValues": { "title": "List of values", "description": "List of values to filter on in the specified fields.", "type": "array", "required": true, "items": { "value": { "type": "string" } } } } }, "maxResultSize": { "description": "Positive integer that defaults to 1000", "required": false, "title": "Max result size", "type": "number" } } }

Expected output metadata

Output metadata is calculated dynamically according to Marketo documentation.

Example of an input message

{
  "searchTerm0": {
    "filterType": "id",
    "filterValues": ["210","211","339","344","214","215","216"]
  }
}

Lookup activities

Lookup activities by criteria.

Lookup Activities

List of expected config fields

List contains default object types and custom object types.

Emit behaviour

Options are:

Emit individually

Emits each object in a separate message.

Fetch all

Emits all objects in one message.

Example of an input message

{
  "activityTypeIds": [1],
  "sinceDatetime": "2015-04-21T20:51:56.790Z"
}
If you want to generate the sample for Fetch all behavior, use a smaller date-range in your filter criteria. If you do not select a small period, you receive a retrieve sample timeout error.

Lookup object (at most 1)

Lookup object by unique criteria.

Lookup Object (at most one)

List config fields

Object type

List contains default object types and custom object types.

Supported default object types:

  • Companies

  • Leads

  • Named accounts

  • Opportunities

  • Opportunity roles

  • Salespersons.

Lookup criteria

List needed to choose kind of field(s) for lookup criteria.

All object types support the following lookup criteria.

Lookup Criteria:

  • Marketo ID

  • Dedupe Fields.

Except for Leads where only Marketo ID is supported.

Allow empty result

No

An error is thrown when no objects are found.

Yes

An empty object is returned instead of throwing an error.

Default

No.

Allow criteria to be omitted

No

An error is thrown when criteria are missing in metadata.

Yes

An empty object is returned instead of throwing an error.

Default

No.

Expected input metadata

Input metadata depends on object type and lookup criteria.

Expected output metadata

Output metadata is calculated for defined object types dynamically according to Marketo documentation.