Integration with Marketo

Your Marketo integration with InEvent can include created lists, associated emails, given names, or attached tags. You will be able to automatically import all data captured on Marketo's landing pages to the InEvent platform, and also export your data from the InEvent event platform to Marketo. Synchronization occurs automatically and allows custom fields to be used.

How do I enable or disable the Marketo integration?

To enable this feature, go to Account > Tools. Click the Registration section and locate Marketo. Press Edit and toggle its button on. Press End to save the changes.

Marketo enabling

Integrating InEvent with Marketo

To integrate InEvent with Marketo, go to Integrations > Marketo. As soon as you click on it, a page will load and you will fill in the blanks:

  • ClientId
  • ClientSecret
  • MunchkinID
Screenshot showing a spreadsheet import interface

To find out the data above: clientId, clientSecret, and munchkinId, you need to access your Marketo account.

Accessing your Marketo account

Creating a new role
  1. Click on Admin > Security > User & Roles.
  2. In Roles, you must click on New role. 
  3. Type API Role under Role name.
  4. Select the Access API (35 of 35) option.
  5. Click on Create
  6. You will see the recently created Role on your screen just after you finish the step above. 
Access your Marketo account

Creating a new user

To do this, click on Users > Invite new user and follow the steps below:

  1. Step 1 INFO: Add Email, First name, and Last name (it must be written API). Then, click on Next.
Step 1 - Add Email, First name and Last name (it must be written API). Then, click on Next.
  1. Step 2 Permissions: You must check the 'API' option and also the 'API Only' and click on the Next button. Note: The API Only option is mandatory. 
Screenshot showing a spreadsheet import interface
  1. Step 3 MESSAGE: Just click on Send to finalize the process
Step 3 - Send to finalize process

Setting up the integration

The next step is to configure the Integration,

  1. Click on Admin > Integration Launchpoint.
Screenshot showing a spreadsheet import interface
  1. On this screen, you need to create a new service by clicking on New > New service.
  2. You must fill in the fields according to the following image (except the description field, which can contain any text as it makes no difference, and the API Only User should contain the previously created user) and click on Create.
 New > New service. API Only User should contain the previously created user) and click on Create.

Checking information

To check your final information click View details.

The information requested to finish the integration inside our platform is in the details. Then you just copy and paste the clientId and clientSecret into the integration with the Marketo screen.
Client Id and Client Secret information

Finally, the munchkinId can be found on Integration > Munchkin > Munchkin account ID.

Marketo munckinId

Linking your Marketo account with InEvent

After you have gotten the ClientId, clientSecret and munchkinId, add them to their corresponding fields on the Marketo integration screen on InEvent's platform. Then click on Link account.

Screenshot showing a spreadsheet import interface

Once the account is linked, you will see additional information that can be set up.

  • Marketo allows the use of Webhooks to communicate with third party web services. If you wish to set up a webhook integration with Marketo, click on the Setup Webhook button and follow the steps given.
  • Daily API Request Limit: By default this is set to 10,000. There is a daily allocation of at least 10,000 REST API calls per day. You can set the number of calls per day by inputting the number in the box.
  • Track email unsubscriptions from Marketo: If enabled, unsubscribed users on Marketo will not receive email communication in your events.
  • Automatically link events with a new Marketo program: If enabled, it automatically creates a new Marketo program when a new event is created and links the events to the programs.
  • You can also see the API requests made according to date.

screenshot showing the completion of the Marketo configuration

Integration Configuration at the event level

After linking your Marketo Account with InEvent at the company level, you can select your event and continue the configuration of the integration.

To do so, on your event's page click on Settings > Integrations > Marketo.

accessing Marketo on the event level
The integration supports webhooks, which allow the use of the GET or POST HTTP verbs to push or retrieve data from a specific URL. For detailed instructions on in-application creation of Webhooks and how to add them to smart campaigns, please refer to this article.

Program information

Marketo programs
Programs are a core organizational component of Marketo Marketing Activities. They can be a parent to most types of assets, and allow for tracking of membership and success of leads within the context of individual marketing initiatives.

On the Marketo integration page, click on Program. Here, you have the option to select the program you want to link with InEvent.

Select program to link with InEvent

Once you have linked a Marketo Program with your event, you will be able to synchronize your attendees, Lists, Activities, and Custom fields.

Attendees

To synchronize attendees, you must click on Synchronization > Sync attendees. You will be notified by email when the synchronization is ready.

Attendees' sync

After the synchronization has been confirmed in your email, your information will be updated on the integration information page.

To see the new attendee's information you must update your View Attendees page (F5) and all new information will be updated. Automatic synchronization takes place at every hour.

All attendees who are synchronized via integration with Marketo will be flagged with a lightning bolt in the Attendees page. To see additional information for each attendee, click on Edit and select the person you want. Additional information is available on the right side of your screen.

You also have the option to export data to any custom list anywhere on Marketo by pressing the Export to Marketo buttons on attendees, invitees and lists.
There will be no refund option for leads that are added to Marketo folders and pushed to InEvent, which results in registration credits consumption.

Lists

In the Lists section, you can link your InEvent Lists with your Marketo Static Lists.

Screenshot showing a spreadsheet import interface
Linking Lists

To link your InEvent and Marketo Lists, simply select the target lists using the drop down box and click Link lists.

Screenshot showing a spreadsheet import interface

Once a link is created, the interface will display additional options: List controls and Synchronization.

You can link as many lists as needed.
In Marketo, linked InEvent Lists will be displayed in a Program folder with the same name as your event.
List controls

Using List controls, you can see and configure which automation controls are activated for your integration. Available automation controls are listed below:

Screenshot showing List controls in the Marketo integration interface
  • Read-only (InEvent reads from Marketo): InEvent will only pull data from your Marketo list into your event list.
  • Write-only (InEvent writes to Marketo): InEvent will only push data from your event list to your Marketo list.
  • Read/Write (InEvent reads and writes on Marketo): InEvent and Marketo will exchange data with one another (both pull and push actions).
Synchronization

Start the list synchronization process with the configured controls by clicking Sync attendees.

Screenshot showing the Synchronization section in the Marketo integration interface

Activities

In the Activities section, you can synchronize attendees of specific activities in your event into a Marketo Static List.

Only attendees who have joined your activity will be synchronized using this feature.

To synchronize your activity attendees with Marketo, follow the instructions below:

  1. Enable activity synchronization by pressing the Enable activity sync toggle in the Activities interface.
The Activities tab will only be visible once you have linked a Marketo Program with your event. Therefore, ensure that you have successfully linked a Marketo Program with your event before proceeding.
Screenshot showing the Enable activity sync toggle in the Activities interface.
  1. Refresh your browser page. The interface will display the activities in your event.
Screenshot showing the Activities section with activities displayed.
  1. Select the activity you wish to sync with Marketo by activating the Enabled toggle button.
You can synchronize as many activities as needed.
Screenshot showing the Activity Sync toggle enabled.
  1. Refresh your browser page. The interface will display a Sync now button beside the selected activity.
  2. Press Sync now to start synchronizing activity attendees.
    Screenshot showing the Activity Sync toggle enabled and the Sync now button highlighted.
    Once the synchronization is finished, the number of synchronized activity attendees will appear under Sync.
    Screenshot showing the number of successfully synchronized activity attendees.
Your synchronized InEvent activities will be displayed in Marketo as Static Lists within the InEvent Sessions folder.

Fields

Under Fields, you will be able to link your custom fields from Marketo with your custom fields from InEvent.

Custom fields
Modification on fields will only be reflected on value changes.

Logs

In the Request logs field, you can view the date and the corresponding number of API requests made on that date.

Request logs

Additional Information

  1. Program controls: Here you will see which automation controls are activated for your integration.
  2. Membership status: Here you will be able to see the status of the different types of lists.
  3. My tokens: Here you will see the list of tokens. When using a token, you also want to provide a default value. This is the text that displays if a person doesn't have a value for the field it references.

InEvent currently offers My Tokens integration on Marketo for the following tokens:

  • Event ID: The InEvent event identifier;
  • Event Name: The InEvent event name;
  • Event Email: The InEvent event email;
  • Event Website: The InEvent event website;
  • Event Date Begin: The InEvent event start date;
  • Event Date End: The InEvent event end date;
  • Event Registration Form: The InEvent event registration form URL;
  • Event Main Page: The InEvent event main page (with magic link);
  • Event Virtual Lobby: The InEvent event virtual lobby page (with magic link).
You will only be able to use tokens containing a magic link when having Marketo ID Auth tool enabled.
Additional Information

How do I import contact information from Marketo to InEvent?

You can easily import the information of Invitees from Marketo to InEvent.

To import Invitees, follow these steps:

  1. Go to People > Invitees.
  2. Click on Edit at the top right corner of the page.
  3. Click on the Import from Marketo button at the top left corner of the page.
Screenshot showing a spreadsheet import interface

  1. Select the Marketo list that you want to import your Invitees from.
  2. Click on the Import button.
Screenshot showing a spreadsheet import interface

After clicking on Import, all the Invitees imported from the chosen Marketo list will appear on the page. You will have access to their name, username, telephone, company, email, and other information.

How do I export contact information from InEvent to Marketo?

You can edit the details of attendees and invitees on the InEvent platform and directly export the updated information into a Marketo list.

To export attendees' information to Marketo, navigate to People > Attendees. To export invitees' information, navigate to People > Invitees. Follow these remaining steps on either page:

  1. Select the attendee or invitee you wish to export.
  2. A window will open at the right-hand corner of the page. Click on Edit to update the person's information.
  3. Next, click on the Export to Marketo button, which will appear at the top of the page.
Screenshot showing a spreadsheet import interface

  1. Select the Marketo list you want to send the information to from the drop-down menu.
  2. Click on the Export button.
Screenshot showing a spreadsheet import interface

You will receive a notification from Marketo once the synchronization is complete.

Additionally, you can export all attendees or invitees at once by clicking on Edit > Export to Marketo once you navigate to People > Attendees or People > Invitees.

How do I activate the Marketo ID Auth for an event?

To enable this feature, go to Settings > Tools, and click on the Login section. Press Edit and toggle the button beside the Marketo ID Auth tool to show green. Press End to save the changes.

Screenshot showing a spreadsheet import interface

If you see a padlock beside the tool, it means you need to enable it at the company tools page .

Once the tool is enabled, you will have a link example in your Marketo Settings that you can use to generate magic links directly on Marketo.

In terms of API requests, 5 to 6 API calls are sent per registration.
You can rename the Marketo program created by InEvent manually on Marketo, but it may break the integration since Marketo uses the name to integrate. In that case, our recommendation is to not activate the automatic program creation. Create it manually on Marketo, and then link it with an event.


How Did We Do?