Below you will find necessary information how to get started with the Marketo integration.
This connector uses the API to push new leads, fetch existing leads (through the export api), and fetch lead activity. You may create a new api user or use an existing one to grant Hull access to your Marketo instance. You may read more about how to obtain api credentials from Marketo at this link: https://developers.marketo.com/rest-api/authentication/
Add Connector
.Marketo
.Install
.Settings
tab and fill out the Credentials section under Connect with Marketo
The following sections describe how to configure the different aspects of the Marketo Connector. The connector synchronizes Hull Users to Leads.
The Marketo connector allows you to configure a multi-fallback identity strategy. This identification strategy can be configured in the “User - Identity” section in the settings. Choose which Hull identifier maps to which Marketo identifier. For example, if there is another field you wish to use as an identifier, you may click “Add new item” and map an Marketo field to “externalId” and your custom id will be used to resolve users.
For outgoing traffic (Hull -> Marketo) we use the Marketo upsert endpoint to push the user. The connector will try the identifiers in order and upsert based on the first identifier found.
For incoming traffic (Marketo -> Hull) we will pull the Marketo id as the anonymous id. As usual, only the attributes which are specified in the incoming user attributes and user identity are synchronized.
This section outlines the steps in order to receive users (leads) from Marketo. Please note that incoming users cannot be filtered. In order to fetch only a subset, you must remove the unwanted Leads from Marketo.
The initial fetch from Marketo is a computationally intensive action which requires monitoring by our Customer Success team. If you would like to backfill your users, then please request the operation from our support team. When requesting, please note whether you want to back fill a subset of data, or if you want to back fill all attributes. A subset of attributes may be faster, but if you decide later you want more attributes, then you may have to do a refetch.
Once the connector is setup, the data begins to flow between systems, Hull will begin to fetch data updates on regular intervals. As with manual fetches, incoming users cannot be filtered. If you wish to not import users into Hull, you must remove them from Marketo. User deletion not currently a supported feature.
Marketo Lead Properties
are stored in Hull User Attributes
This section outlines the steps in order to send users from Hull to Marketo (outgoing user data)
Hull User Attributes
are updated/created on Marketo Lead
and the field they are mapped to.The Marketo connector allows you to synchronize data between Hull and Marketo for the following objects:
Hull Entity | Marketo Entity |
---|---|
User | Lead |
No other objects besides the ones listed above are supported. If you need to synchronize additional objects please reach out to our customer success team to explore the options on a case-by-case basis.
If you would like Marketo Account support, please contact our solutions team. Typically there will be account support for Marketo if you have a Salesforce instance which is connected to your marketo instance
The Marketo connector receives updates to Hull Users
in near real-time and makes requests to the Marketo API. The data synchronization maps the default attributes to Marketo properties according to the tables below. If you have defined custom properties in Marketo and configured mappings, the synchronization will also contain these fields.
Additionally you can manually select Hull Users
in the Hull web application and send them to the connectorby clicking Send to
. This will bypass segment filtering and force update of Marketo Leads
.
The Marketo connector is built to pull new data from your Marketo instance on a 5 minute scheduled interval. As always, make sure to populate your Incoming User Attributes and provide a mapping to which fields you want the Marketo data populating. Our recommended approach is creating new Marketo specific fields for each of the incoming Marketo attributes.
Fetching the existing data in Marketo is known for being a complex and time consuming process. The process involves specifying 30 day increments to export. By default Hull exports the last 3 years of leads (configurable if needed) which is 36 exports. These exports can sometimes fail so monitoring is required if particular exports need to be recreated. In addition, there is a 500MB daily export limit which means that many times these exports may take several days.
This is why we encourage our customers, if an initial import is needed to contact our support team. That way we can kick off the process and monitor it to completion.
Because the initial fetch is such involved process, we give our customers the option of exporting all of the datapoints over from Marketo. Typically we let the customer specify the datapoints to be imported. That’s still an option, but we give the additional option to get everything that way you won’t have to do another fetch if you missed a needed datapoint.
Because of the volume that some campaigns can produce, we encourage you to share with the support team the frequency and possible size of campaigns that are being executed in Marketo. That way we can be sure to allocate the proper compute resources during traffic spikes.
Marketo can generate a lot of traffic as campaigns are activated, or attributes are updated.
Check your connector logs for any incoming.job.error
. If you see any with Unauthorized
go to the Settings
Tab, and confirm that the credentials are correct under the Connecto to Marketo
section. Also ensure that the user you’ve specified has permissions to do user exports and use the API. Right after it’s done the incoming dataflow should be resumed. You can verify that by searching for any incoming.user.success
or incoming.account.success
log lines (it can take around 5 minutes to show up).
You may explicitly send particular users by searching for them in the Hull web app, and clicking the checkbox on the left side of each row. Then, in the upper right hand corner of the interface you can click “Send to” and specify which connector you want to send the users/accounts to.
Make sure that you’ve configured the incoming attributes in the Fetching Users from Marketo
section of the Settings
Connector tab.
Learn how Hull unifies and syncs customer data by watching our product tour