Marketo Connector
The Marketo connector lets you add, search, and update leads into Marketo in your PingOne DaVinci flow.
You can use the Marketo connector to:
-
Manage leads in Marketo
-
Manage lists in Marketo
Setup
Resources
For information and setup help, see the following:
-
Marketo documentation:
-
-
DaVinci documentation:
-
-
Setting up Marketo
Follow the instructions in Marketo Setup Checklist.
Configuring the Marketo connector
Add the connector in DaVinci as shown in Adding a connector, then configure it as follows.
Using the connector in a flow
Lead management
The connector has several capabilities that allow you to manage users:
-
Create Lead
-
Read Lead
-
Update Lead
-
Search Lead
No special configuration is needed. Add the capability and populate its properties according to the help text.
List Management
The connector has several capabilities that allow you to manage lists:
-
Create Static List
-
Get List Information
-
Read Static List Leads
-
Add Leads to List
No special configuration is needed. Add the capability and populate its properties according to the help text.
Creating a custom API call
If you want to do something that isn’t supported by one of the provided capabilities, you can use the Make a Custom API Call capability to define your own action.
This capability uses the credentials from your connector to make an API call with the HTTP method, headers, query parameters, and body you specify.
Capabilities
Create Lead
Create a new lead.
Show details
- Properties
- First Name
textField
-
The user’s first name.
- Middle Name
textField
-
The user’s middle name.
- Last Name
textField
-
The user’s last name.
- Email
textField
required
-
The user’s email address.
- Phone Number
textField
-
The user’s phone number.
- Custom Attributes
keyValueList
-
Additional attributes.
- Output Schema
- output
object
- rawResponse
object
- properties
object
- result
object
- properties
object
-
- requestId
string
- result
object
- properties
object
- requestId
- id
string
- status
string
-
- success
string
- success
- statusCode
number
- headers
object
Create Static List
Create a new static list.
Show details
- Properties
- List Name
textField
required
-
Enter a name for the new list.
- Output Schema
- output
object
- rawResponse
object
- properties
object
- result
object
- properties
object
-
- id
number
- name
string
- createdAt
date
- updatedAt
date
- folder
object
- properties
object
- id
- id
number
- type
string
- name
string
-
- computedUrl
string
- computedUrl
- statusCode
number
- headers
object
Get List Information
Get information about one or more lists using the list ID, name, or folder.
Show details
- Properties
- Search Type
dropDown
required
-
Select “Use List ID” or “Use List Name” to get information about a single list, or select a folder to get information about all lists within it.
-
Use Folder Name (Default)
-
Use List ID
-
Use List Name
-
- Folder
dropDown
required
-
Select the folder that contains the lists you want information about.
- List Name
textField
-
The name of the list to get information about, such as "Founders".
- List Type
dropDown
-
Select the type of list you are reading. Smart lists support additional accuracy and functionality.
-
Static List (Default)
-
Smart List
-
- List ID
textField
required
-
The unique ID for the list, such as "56789".
- Output Schema
- output
object
- rawResponse
object
- properties
object
- result
array
- items
array
-
- type
object
- properties
- type
- statusCode
number
- headers
object
Read Lead
Read a lead using the lead ID.
Show details
- Properties
- Lead ID
textField
required
-
The unique identifier for the lead, such as "318581".
- Output Schema
- output
object
- rawResponse
object
- properties
object
- result
object
- properties
object
-
- requestId
string
- result
object
- properties
object
- requestId
- id
string
- email
string
- firstName
string
- lastName
string
- updatedAt
string
- createdAt
string
-
- success
string
- success
- statusCode
number
- headers
object
Update Lead
Update an existing lead using the lead ID.
Show details
- Properties
- Lead ID
textField
required
-
The unique identifier for the lead, such as "318581".
- First Name
textField
-
The user’s first name.
- Middle Name
textField
-
The user’s middle name.
- Last Name
textField
-
The user’s last name.
- Email
textField
required
-
The user’s email address.
- Phone Number
textField
-
The user’s phone number.
- Custom Attributes
keyValueList
-
Additional attributes.
- Output Schema
- output
object
- rawResponse
object
- properties
object
- result
object
- properties
object
-
- requestId
string
- result
array
- items
array
- requestId
- type
object
- properties
-
- success
string
- success
- statusCode
number
- headers
object
Search Leads
Search for one or more leads.
Show details
- Properties
- Search Attribute
dropDown
required
-
Select the Marketo lead attribute that you want to search.
-
Cookies
-
Department
-
Email
-
Email Suspended Cause
-
External Company ID
-
External Sales Person ID
-
ID
-
Lead Partition ID
-
Marketo Name
-
- Search Values
textField
required
-
Enter the values to look for in the search attribute. Separate multiple values with a comma, such as "138273,jsmith@example.com".
- Output Schema
- output
object
- rawResponse
object
- properties
object
- result
object
- properties
object
-
- requestId
string
- result
array
- items
array
- requestId
- type
object
- properties
-
- success
string
- success
- statusCode
number
- headers
object
Read Static List Leads
Read leads in a static list using the list ID.
Show details
- Properties
- List ID
textField
required
-
The unique ID for the list, such as "56789".
- Output Schema
- output
object
- rawResponse
object
- properties
object
- result
object
- properties
object
-
- requestId
string
- result
array
- items
array
- requestId
- type
object
- properties
-
- success
string
- success
- statusCode
number
- headers
object
Add Leads to List
Add leads to a list using lead IDs.
Show details
- Properties
- List ID
textField
required
-
The unique ID for the list, such as "56789".
- Lead IDs
textField
required
-
Enter the unique ID of the leads to add to the list. Separate multiple values with a comma, such as "456123,987654".
- Output Schema
- output
object
- rawResponse
object
- properties
object
- result
object
- properties
object
-
- requestId
string
- result
array
- items
array
- requestId
- type
object
- properties
-
- success
string
- success
- statusCode
number
- headers
object
Make Custom API Call
Define and use your own call to Adobe Marketo.
Show details
- Properties
- Custom Endpoint
textField
required
-
This endpoint is added to the base API URL selected in the connector configuration. Remeber to removed "rest/" from the endpoint
- HTTP Method
dropDown
required
-
The HTTP method of the API call.
-
GET
-
POST
-
PUT
-
DELETE
-
PATCH
-
- Query Parameters
keyValueList
-
Query parameters for the request.
- Additional Headers
keyValueList
-
Define additional headers to send to Adobe Marketo. For help, see the API documentation.
- Body
codeEditor
-
The body of the API call.
- Output Schema
- output
object
- rawResponse
object
- statusCode
number
- headers
object