The Marketo integration allows you to easily import your Marketo leads into NeverBounce and send the results back to Marketo.

NOTE: This integration is not available for Marketo’s Spark level of membership

Getting StartedAnchor

To get started with this integration, visit the NeverBounce dashboard and select ‘Marketo’ from the Import dropdown. A new modal will open and will prompt you for Marketo credentials including your account ‘Munchkin Account ID’ and API credentials. (Below you’ll find instructions for finding these credentials.)

Additionally if you wish to use the ‘Export to Marketo’ feature, you will need to create two fields in Marketo to receive the results. You can also find instructions for this below.

Finding the CredentialsAnchor

For NeverBounce to connect to your account Marketo account, we need three pieces of information: your Marketo ‘Munchkin Account ID’ along with the ‘Client ID’ and ‘Client Secret’ from a custom Marketo Service created within your account.

Finding the Munchkin Account ID

To retrieve the ‘Munchkin Account ID’, navigate to the Admin tab in your Marketo dashboard. Once here expand the Integrationoption in the menu on the furthest-left side of the screen. You should now see a link called Munchkin. Follow this link to the Munchkin page. Here you will see the Munckin Account ID in the Tracking Code group. It should look simliar to this: xxx-xxx-xxx. This is the Munchkin Account ID needed on the NeverBounce dashboard.

Creating a Custom Service in Marketo

Creating a custom service in Marketo allows you to grant limited API access for integrations to interact with the data in your account. Before creating the custom service, you will need to create a new Role and User for the service to operate as.

Below you will see instructions for creating a new User, Role and Custom Service. Be sure to consult theMarketo documentation for the most up-to-date instructions.

Adding a User and User Role

On the Admin tab of your Marketo dashboard, expand the Security option in the left-hand menu. Follow the Users & Roles link.

We’ll first create a new Role for the User that is created. Click the Roles tab and create a new Role by clicking New Role. Here you can name the Role something descriptive such as ‘NeverBounce Integration’, and add a description if you wish.

The permissions are what really matter when creating the Role. The required permission option is Read-Write Lead. Be sure you have enabled this permission for this role; no others are required. Click ‘Create’ and the new Role is created.

Now we can create the user. Click the Users tab and then Invate New User to get started. Fill out the First Name, Last Name and Email Address with whatever you would like. Something descriptive is suggested. In the roles field be sure to select the role we created in the last step. Finally tick the API Only option and click invite.

Adding a Custom Service

Now that the user and user role has been created, navigate to the LaunchPoint page by following the link in the left-hand menu. (It may be necessary to expand the Integration option.)

On the LaunchPoint page, click New and then New Service. Name this service what you would like; again something descriptive is recommended. Under the service field select Custom. You will now see aDescription and API Only User field. The description can be whatever you’d like. The API Only User however needs to be the User that was just created. Select that User and click ‘Create.’

Once it has been created, click the View Details link on the newly created service. Here you should see the Client Id andClient Secret. These are the two additional credentials needed on the NeverBounce dashboard.

Creating the Custom FieldsAnchor

To export results back to Marketo directly, you will need to create two fields in your Marketo account.

Logged into your Marketo account, go to the Admin tab and follow the Field Management link in the left panel. On the Field Management page, click the New Custom Field link. Use this form to create each custom field. Below you will find the fields you need to create. Be sure to enter them as they appear below:

Field #1

  • Type: String
  • Name: NeverBounce Validation Result
  • API Name: neverBounceValidationResult

This field will contain one of the five strings ‘Valid’, ‘Invalid’, ‘Catchall’, ‘Disposable’, ‘Unknown’.

Field #2

  • Type: Datetime
  • Name: NeverBounce Validation Date
  • API Name: neverBounceValidationDate

This field will contain the date of validation.

Using the IntegrationAnchor

Once you’ve enter all three credentials in the NeverBounce dashboard, click ‘Save’ and a connection will be made to your account. You will then see a selection screen with the lists from within your Marketo account. Once you select a list and click ‘Import’ it will begin the process of importing the list and creating a job.

When the importing process has completed, you will see a new job on screen with the Marketo logo. This job can either be analyzed or validated.

If you choose to validate it, you can then click the ‘Export to Marketo’ to send the results back to Marketo directly. If you’d rather download the results, select the ‘Download’ option from the dropdown next to ‘Export to Marketo’.


Where are my Smart Lists?Anchor

The purpose of validating should be to use the validation results to create rules for including contacts in Smart Lists, this is why your Smart Lists are not available for validation.

I’m receiving an error when trying to import my list.

This is typically related to Marketo’s API limits. If you have several third party integrations or a custom integration, there is a good chance you may have reached your daily limit for API transactions in Marketo. Contacts have to imported in batches of 300 from Marketo, so a list of 10,000 contacts would result in 333 API requests.

My import has been processing for a while, how long does it take? Why isn’t there a progress bar?

Importing can take several minutes for a few thousand contacts and upwards of an hour or more for larger numbers of records. This is due to the throttling put in place by Marketo which limits the number of API requests that can be made in a small time frame. Unfortunately we are unable to provide a progress indicator as we are unable to retrieve the total number of contacts in a list until importing has completed.