You can use the Lead Write Snap to interact with leads using commands and make modifications to the Lead database. Lead Database objects include the following:
Leads
Companies
Named Accounts
Named Account List
Static List
Opportunities
Opportunity Roles
Sales Persons
Custom Objects
Activities
Prerequisites
A valid account with the required permissions. See Roles and Permissions for more information.
Daily Quota: The subscriptions are allocated 50,000 API calls per day (which resets daily at 12:00AM CST).
API Rate Limit:All Marketo APIs are rate-limited. The API access per instance is limited to 100 calls per 20 seconds.
Concurrency Limit: You can make a maximum of 10 concurrent API calls.
Known Issues
If the API rate limit of 100 calls per 20 seconds exceed, the API responds with a 606 error code and the Snap fails.
This Snap fails with 709 error on selecting Update Email Full Content, Update Landing Page Dynamic Content Section, Approve program, and Activate smart campaign commands.
This Snap fails with 702 error on selecting Delete Landing Page and Discard Email Draft commands.
This Snap fails to discard drafts with 1003 error on selecting Discard Custom Activity Type Draft command.
Marketo Snaps do not support some special characters (for example, (𝖖𝖗𝖘𝖬𝖭𝖮𝗕𝗖𝘧𝘨𝘩𝛀𝛁𝛂𝛃𝛄𝛅𝛆𝛇,𝖗𝖘𝖬𝛌𝛗𝛘𝛙𝛴).
Snap Input and Output
Input/Output
Type of View
Number of Views
Examples of Upstream and Downstream Snaps
Description
Input
Document
Min: 0
Max: 2
Mapper
Copy
Write to the Lead database using a command.
Output
Document
Min: 0
Max: 1
Mapper
Copy
Results returned by Marketo.
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
Description
Label*
Specify an unique label for the Snap.
DefaultValue: Lead Write Example: Department Members
Command*
Enter the command to query the Asset database to retrieve the desired records. Alternatively, click the Suggestion icon to fetch a list of commands.
DefaultValue: N/A Example: Merge Leads
Query Parameters
You can use this fieldset to define the name and value for query parameters on request.
Ensure that the query parameters are unique and not defined in both input documents and properties.
Name
Specify the name of the query parameter for retrieving assets.
Default Value:N/A
Example: leadIds
Value
Specify the value for the query parameter for retrieving assets.
Default Value:N/A
Example: 17 or 17,18
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.
DefaultValue: Validate & Execute Example: Validate and Execute
Troubleshooting
Error
Reason
Resolution
An error occurred reading from Marketo (609 error).
Invalid attribute value.
Add toString() to your expression in the Command field.
Example
Writing A Lead To the Lead Database
The following example Pipeline demonstrates how we can sync a lead to the Lead database using the Lead Write Snap.
Initially, we pass the following required lead values and account name in the Pipeline as key-value parameters.
Key
Value
MarketoAccountName
DG_Marketo_Account
FirstName
John
Gender
Male
LastName
Doe
We begin with mapping the lead information using the Mapper Snap.
Upon validation, we see the lead information in the output preview of the Snap.
Next we configure the Lead Write Snap, to insert the lead information into the folder which is in the Lead database.
Upon validation, we see a confirmation on the lead created in the Lead database.
Updated and certified against the current SnapLogic Platform release.
August 2024
main27765
Stable
Upgraded the org.json.json library from v20090211 to v20240303, which is fully backward compatible.
May 2024
main26341
Stable
Updated and certified against the current SnapLogic Platform release.
February 2024
436patches25142
Latest
Fixed an issue with the Marketo Bulk Import and Bulk Lead Extract Snaps where the timeout was not disabled when the Timeout setting was set to 0.
February 2024
main25112
Stable
Updated and certified against the current SnapLogic Platform release.
November 2023
435patches24804
Latest
Fixed an issue with the Marketo Bulk Extract Snap where the timeout was not disabled when the Timeout setting was set to 0.
November 2023
435patches24332
Latest
Enhanced the Marketo Asset Read Snap to enable pagination when the maxReturn input query parameter value exceeds 200. We recommend you to set the maxReturn value to 0 or a large integer to fetch all the records.
November 2023
435patches24248
Latest
Enhanced the Marketo Bulk Extract Snap by adding the Include export ID checkbox. When you select this option, the Snap displays the export ID in the output.
Added support to Marketo Bulk Lead Extract to display the Export ID in the output.
November 2023
main23721
Stable
Updated and certified against the current SnapLogic Platform release.
August 2023
434patches22837
Latest
Updated the input and output schema for the Marketo Snaps.
August 2023
main22460
Stable
Updated and certified against the current SnapLogic Platform release.
May 2023
433patches21541
Latest
Fixed an issue with the Bulk Extract and Bulk Import Snaps where the API name was inaccessible when expressions were enabled for the Marketo Entity field and Custom Objects were selected.
May 2023
433patches21295
Latest
Fixed an issue with the Marketo Bulk Extract Snap where the Snap failed to extract data from the CSV file when the data consisted of the backslash (\) character.
May 2023
main21015
Stable
Upgraded with the latest SnapLogic Platform release.
February 2023
432patches20585
Latest
The Marketo Bulk Extract Snap works successfully in the non-lineage path within an Ultra task.
February 2023
main19844
Stable
Upgraded with the latest SnapLogic Platform release.
November 2022
431patches19248
Latest
The Marketo Lead Read Snap includes a new Read All Pages checkbox, which enables you to fetch all records for a selected command.
November 2022
431patches18969
Latest
The Marketo Bulk Import Snap now imports data for the selected Custom Objects. It also displays an error for invalid data or a mismatch of data type.
November 2022
main18944
Stable
The Asset Write Snap now supports special characters.
The Asset Read, Asset Write, Lead Read, and Lead Write Snaps now have a new field set, Query Parameters, which enables you to define additional parameters for retrieving the asset details.
Ensure that the query parameters are unique and not defined in both input documents and properties.
October 2022
430patches18810
Latest
The Marketo Asset Write Snap no longer fails with 601 and 602 errors when the OAuth access token expires or is invalid.
October 2022
430patches18707
Latest
Introduced Bulk Extract and Bulk Import Snaps that enable you to perform Bulk operations on specific entities.
The Asset Read, Asset Write, Lead Read, and Lead Write Snaps now have a new field set, Query Parameters that enables you to define additional parameters for retrieving the asset details.
Fixed support for special characters in the Asset Write Snap.
August 2022
main17386
Stable
Upgraded with the latest SnapLogic Platform release.
4.29 Patch
429patches16430
Latest
Fixed an issue with Marketo OAuth2 Account where the Snaps failed with ACCESS TOKEN EXPIRED error. Now the Snaps that use Marketo OAuth2 Account work as expected and does not display an expired token error.
Fixed an issue with Marketo Bulk Lead Upsert Snap where the Snap processed only successfully submitted batch jobs. Now, the Snap processes the failed batch jobs and logs the response message for each status.
Fixed an issue with Marketo Bulk Lead Upsert and Bulk Lead Extract Snaps where the Snaps did not display valid error messages for Timeout and Number of Retries property when the input is large, empty, or Null.
Upgraded with the latest SnapLogic Platform release.
4.26 Patch
426patches11555
Latest
Fixed an issue with the Marketo Lead Read Snap, wherein the Snap generated the same next page token anytime during the day.
4.26
main11181
Stable
Upgraded with the latest SnapLogic Platform release.
4.25
main9554
Stable
No updates made.
4.24
main8556
Stable
No updates made.
4.23-Patches
423patches7812
Stable
Latest
Introduces the Marketo Snap Pack to enable automating the process of performing operations to the Asset database and Lead database that manage the potential data for an organization in the marketing industry.
): Indicates a list that is dynamically populated based on the configuration.
