Marketo is a marketing automation platform that enables marketers to manage personalized multi-channel programs and campaigns for prospects and customers.
For the complete overview of our integration with Marketo, feel free to read our dedicated article.
In this article, we'll show you how to set up Marketo and connect it with Livestorm.
This feature is available for Enterprise customers.
In this article
Set Up Marketo
To authenticate your Marketo application, you will need three elements: your Client ID, your Client secret, and your Account ID. Let’s see how to get them. 😉
Create an API Role
First, you will create a “fake” user in your account, also known as API role.
- 1
- Go to Admin > Security > Users & Roles and click on Invite new user.
- 2
- Fill in the first form (no email will be sent to invite this fake user). Remember the email address as we will use it in the next step.
- 3
- You will then need to set permissions like in the screenshot below (API role + API Only).
- The permissions of the API Role should be configured in Admin > Users & Roles > Roles with (at least) these permissions:
- Access User Management API
- Read-Write Activity
- Read-Write Assets
- Read-Write Campaign
- Read-Write Person
- Read-Write Activity Metadata
- Read-Write Schema Custom Field
- Read-Write Schema Standard Field
- 4
- Then, proceed through the last step. You are done! 🎉
Create a New Launchpoint
- 1
- Go to Admin > Integration > Launchpoint and click on New > New service.
- 2
- Choose a display name of your choice (Livestorm for example).
- 3
- Select Custom as Service.
- 4
- Provide a description.
- 5
- In the API Only User field, select the email you've previously entered and then click on Create.
Get Your Client ID & Client Secret
- 1
- Go to Admin > Integration > Launchpoint and click on View details for the service you want to use (”Livestorm”, in our case).
- 2
- Here you will find your Client ID and Client Secret.
Get Your Account ID
- 1
- Go to Admin > Integration > Webservices.
- 2
- In the "Rest API" section, copy the ID appearing in the Endpoint link (for example, here the ID is 578-JCM-841).
- 3
- This is your Account ID.
Connect Marketo With Livestorm
- 1
- Go to your App marketplace in your Livestorm Dashboard and select the Marketo card.
- 2
- Then, simply copy-paste your Client ID, your Client Secret and your Account ID in the following highlighted fields and click on Connect.
- 3
- When everything looks like, this you are authenticated. 🎉
Link a Livestorm Event With a Marketo Program
Now that your app is authenticated (see previous part), you can link a Livestorm event with a Marketo program.
- 1
- Go to your Event > Settings > Apps and click on Select Marketo Program.
- 2
- Then, you can see a small list of Marketo Programs. This list does not contain all your Marketo Programs, but instead only some recent ones updated recently by Marketo. If you can find the Program you are looking for in the list, this is great, select the Program you wish to send data to.If the your Program is not present in the small list. You have to search for it. To do that, enter the exact name (it has to be the full and exact name of your Program without spelling mistake - this is a requirement from Marketo to perform a search) of your Program in the search bar and press the button "Search in older Marketo Programs".
Then, you should see one result with your Program name, select this Program and the save is automatic.
- 3
- You are now good to go! 🎉
Data Sent From Livestorm to Marketo
Each time someone registers to your event :
- We will create (or update) a Lead in Marketo (with email, first name, last name if they are provided).
- We will associate this Lead as a Program Member to the Program you've linked the event to.
When the event ends we update the Program member Status like this:
- The default status is "Registered".
- If Lead did not attend, his Program Member status is "No show".
- If Lead did attend, his Program Member status is "Attended".
- If Lead watched an on-demand event, his Program member status is "Attended on-demand".
Please use the default statuses Marketo sets up with the “Webinar” Program template. If you don’t, we won’t be able to select them accordingly.