Getting Started

Marketo is a marketing automation platform that enables marketers to manage personalized multi-channel programs and campaigns to prospects and customers. The Marketo platform can be extended using a number of integration points. Below you will find the core entities and their relationships. To quickly and easily make your first REST call, check out the Quick Start Guide for Marketo REST API.

Note that the following objects are not available via REST API when native sync is enabled: Company, Opportunity, Opportunity Role, Sales Person

 

Person (Leads)

People are the foundation of any marketing automation platform. Within Marketo, all non-sales person records are referred to as leads, regardless of whether they are designated as leads, prospects, suspects, contacts…etc. from a sales perspective. The lead object comes with a set of standard fields such as email, first name and last name. Additional fields can be added to the lead object type in order to extend the types of information associated to records in the system . Custom attributes can be read and written to just as the standard fields. A complete list of fields can be found within the Marketo Admin > Field Management menu. Leads are uniquely identifed in Marketo by the id field. Other unique keys must be enforced externally from the system.

Related APIs: RESTSOAPJavaScript

Activities

Leads interact with your organization in a number of ways. A lead may visit a page on your company’s website, attend a tradeshow or download a whitepaper. Each of these actions can be captured within Marketo to help a marketer better understand which activities a lead did and when so they can coordinate timely and relevant communications. Activities are always related back to leads by leadId.

You can define your own custom activities.  Once you have created and published a custom activity, you can add custom activities via Marketo API.  More information on custom activitities can be found here.

Related APIs: REST, SOAP, JavaScript

Programs & Campaigns

A Program is the mechanism by which a marketer organizes all their different types of marketing efforts from one central location. An example of a program is an email blast. A lead can take multiple actions/activities related to a given program that become associated with the program. This is known as lead progression. An example progression of an email blast program would record when a lead is sent an email, when the person opened the email whether they clicked through a link in the email.

Campaigns are created to serve a specific purpose and specific goal within a Program. An example of a campaign could be to narrow down a group of leads and send them the email blast, or to notify a sales rep for follow up if a lead clicks through a link within the email blast program.

Related APIs: REST, SOAP

Tags

Tags are a way of grouping data for reporting purposes. These identifiers provide the ability to categorize data and define how you want to report on your Program in order to understand Program effectiveness and ROI.

As a Marketo Admin, you have the ability to create required and optional tag types available for selection when a Marketo user creates a Program. Possible values for each of these tag types are defined by you and reflect how your company would like to use custom tags for reporting purposes.

For example, you may want to create a custom “Region” tag type with multiple tag values (e.g. Northeast, Southeast, etc.) allowing you to analyze which region is generating the most leads. Or, for instance, you can create an “Owner” tag type, which allows you to assess and understand which Program owners (e.g. Maria, David, or John) are having the greatest impact on creating new leads and opportunities.  More information about tags can be found here.

Related APIs: REST, SOAP

Lists

Lists allow a marketer to organize a collection of leads. There are two types of lists within Marketo, static and smart. A static list is a fixed list of leads that a marketer can add or remove as they choose. A smart list is a dynamic collection of leads based on a set of designated characteristics. An example of a smart list would be “All leads who have visited the pricing page on our website.” This smart list will continue to grow as more leads visit the pricing page.  More information about lists can be found here.

Related APIs: REST, SOAP

Opportunities

Marketers deliver leads to sales in the form of an opportunity. An opportunity represents a potential sales deal and is associated with a lead or contact and an organization in Marketo. An opportunity role is the intersection between a given lead and an organization. The opportunity role pertains to a lead’s function within the organization.

Related APIs: REST, SOAP

Companies

An organization, sometimes referred to as an account in Marketo refers to the organization that a person belongs to. When using ROI reporting in Marketo or Revenue Cycle Analytics (RCA), it is important to associate people with their organization and opportunities so the proper ROI attribution can be determined.

Related APIs: REST, SOAP

Assets

Assets refer to landing pages, emails, forms and images that are used within a program. Assets can be either local to a given program or global. Global assets are available across any program.

Related APIs: REST

Tokens

Tokens allow a marketer to personalize messages with asssets and add logic within flow actions. There are tokens for the overall system, programs, leads and companies. An example of a lead token is {{lead.First Name}}. This token can be placed within an email to display the lead’s first name.

Tokens defined at the Program or folder level are referred to as “My Tokens” within Marketo. My Tokens can be one of three types, local, inherited or overridden.

program-folder-campaign

My Tokens that are created locally within a specific campaign folder or program are available to that specific program or campaign folder (local). My Tokens that are created at the campaign folder level are available for use across all programs contained within that campaign folder (inherited). My Tokens that are modified at the program level with custom values do not change the parent My Token value of the token at the program folder level (overridden).

My Tokens use the naming convention {{my.My Token}}, with the word “my” added to the beginning of the token name. For example, if you create a Date type My Token with the name EventDate, the name of the token is {{my.EventDate}}.  More information about My Tokens can be found here.

Related APIs: REST, SOAP

Custom Objects

A Marketo custom object allows for the creation of a one-to-many, or many-to-many (Edge-Bridge-Edge) relationship between your Marketo Leads and the custom object records. Once you have created and published a Marketo custom object, you can perform CRUD operations on the custom object via Marketo API. More information about custom object creation can be found here.  When new records are added to the custom object, you can use a smart list trigger to respond. You can also use custom object data as a filter in smart lists (segmentation), or in emails using Email Scripting.

Related APIs: REST, SOAP

Sales Persons

Sales Person records and lead relationships can be managed in Marketo when there is no native CRM integration enabled. These records contain basic information about the Sales Person, such as Name, Email, and Job Title which can be used for filtering and tokens in Marketo when a lead is owned by one. The relationship to a sales person is managed at the lead level through the “externalSalesPersonId” field, which must be updated through the Sync Leads API.

Related APIs: REST