Lead Read

Lead Read

In this Article

Overview

You can use the Lead Read Snap to query the Lead database. Lead database objects include the following:

  • Leads

  • Companies

  • Named Accounts

  • Named Account List

  • Static List

  • Usage

  • Opportunities

  • Opportunity Roles

  • Sales Persons

  • Custom Objects

  • Activities

  • List and Program Membership

snap-lead-read-overview.png

Prerequisites

A valid account with the required permissions. For more info, see Roles and Permissions.

Support for Ultra Pipelines

Works in Ultra Pipelines

Limitations

Known Issues

  • The Get Lead Activities REST API call fails while getting activities for the first page, because it expects a nextPageToken on the first page. Refer to Connecting to Marketo with the REST Snap Pack for a workaround.

  • If the API rate limit of 100 calls per 20 seconds exceed, the API responds with a 606 error code and the Snap fails.

  • Marketo Snaps do not support some special characters (for example, (𝖖𝖗𝖘𝖬𝖭𝖮𝗕𝗖𝘧𝘨𝘩𝛀𝛁𝛂𝛃𝛄𝛅𝛆𝛇,𝖗𝖘𝖬𝛌𝛗𝛘𝛙𝛴).

  • The Marketo Lead Read Snap has the checkbox Read All Pages, which does not apply to all the commands. A few commands (such as Get Paging Token, Member of List) do not support pagination due to the API limitation.

Snap Views

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document

  • Min: 0

  • Max: 2

  • Mapper

  • Copy

Command to query the Lead database.

Output

Document



  • Min: 0

  • Max: 1

  • Mapper

  • Copy

Document with the record on the basis of the input command.

Snap Settings

  • Asterisk ( * ): Indicates a mandatory field.

  • Suggestion icon ( ): Indicates a list that is dynamically populated based on the configuration.

  • Expression icon ( ): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon ( ): Indicates that you can add fields in the fieldset.

  • Remove icon ( ): Indicates that you can remove fields from the fieldset.

Field Name

Field Type

Description

Field Name

Field Type

Description

Label

String

Specify an unique label for the Snap.

Default Value: Lead Read
Example: Customer Leads

Command

String/Expression/Suggestion

Enter the command to query the Asset database to retrieve the desired recordsAlternatively, click the Suggestion 

 icon to fetch a list of commands. 

Some commands require specific data in the input view. In such cases, place the Mapper Snap as an upstream Snap, validate the pipeline and note the Target Schema in Mapper Snap.  Refer to the Marketo Lead Database document for details of each command.

Default Value: N/A
Example: Get Activity Types

Query Parameters

You can use this field set to define the name and value for query parameters on request.

  • This field set only supports pipeline parameters and does not support the upstream values.

  • Ensure that the query parameters are unique and not defined in both input documents and properties.

Name 

String/Expression

Specify the name of the query parameter for retrieving assets.

Default Value: N/A

ExampleactivityTypeIds

Value

String

Specify the value for the query parameter for retrieving assets.

Default Value: N/A

Example12

Read All Pages

Checkbox

Select this checkbox to read all pages from Marketo for the specific input.

This checkbox is not available for Get Pagination Token command.

Default Value: Deselected.

Timeout (seconds)

 

 

Integer/Expression

Specify the time in seconds to wait for the operation to complete before it times out. A value of zero disables the timeout.

 

Default Value0
Example: 1000

Number of Retries

 

 

Integer/Expression

Specify the number of attempts the Snap must make in case of connection failure or timeout.

 

Default Value0
Example: 3

Retry Interval (seconds)

 

 

Integer/Expression

Specify the amount of time in seconds the Snap must wait before each retry attempt.

 

Default Value1
Example: 4

Snap Execution

 

Select one of the three following modes in which the Snap executes:

  • Validate & Execute. Performs limited execution of the Snap and generates a data preview during Pipeline validation, then performs full execution of the Snap (unlimited records) during Pipeline runtime.

  • Execute only. Performs full execution of the Snap during Pipeline execution without generating preview data.

  • Disabled. Disables the Snap and all Snaps downstream from it.

Default Value: Validate & Execute 
Example: Disabled