Ready to get started?

Download a free trial of the Marketo Driver to get started:

 Download Now

Learn more:

Marketo Icon Marketo JDBC Driver

Rapidly create and deploy powerful Java applications that integrate with Marketo marketing automation data including Leads, Opportunities, Channels, Campaigns, and more!

Create a Data Access Object for Marketo Data using JDBI

A brief overview of creating a SQL Object API for Marketo data in JDBI.

JDBI is a SQL convenience library for Java that exposes two different style APIs, a fluent style and a SQL object style. The CData JDBC Driver for Marketo integrates connectivity to live Marketo data in Java applications. By pairing these technologies, you gain simple, programmatic access to Marketo data. This article walks through building a basic Data Access Object (DAO) and the accompanying code to read and write Marketo data.

Create a DAO for the Marketo Leads Entity

The interface below declares the desired behavior for the SQL object to create a single method for each SQL statement to be implemented.

public interface MyLeadsDAO { //insert new data into Marketo @SqlUpdate("INSERT INTO Leads (Country, AnnualRevenue) values (:country, :annualRevenue)") void insert(@Bind("country") String country, @Bind("annualRevenue") String annualRevenue); //request specific data from Marketo (String type is used for simplicity) @SqlQuery("SELECT AnnualRevenue FROM Leads WHERE Country = :country") String findAnnualRevenueByCountry(@Bind("country") String country); /* * close with no args is used to close the connection */ void close(); }

Open a Connection to Marketo

Collect the necessary connection properties and construct the appropriate JDBC URL for connecting to Marketo.

Both the REST and SOAP APIs are supported and can be chosen by using the Schema property.

For the REST API: The OAuthClientId, OAuthClientSecret, and RESTEndpoint properties, under the OAuth and REST Connection sections, must be set to valid Marketo user credentials.

For the SOAP API: The UserId, EncryptionKey, and SOAPEndpoint properties, under the SOAP Connection section, must be set to valid Marketo user credentials.

See the "Getting Started" chapter of the help documentation for a guide to obtaining these values.

Built-in Connection String Designer

For assistance in constructing the JDBC URL, use the connection string designer built into the Marketo JDBC Driver. Either double-click the JAR file or execute the jar file from the command-line.

java -jar cdata.jdbc.marketo.jar

Fill in the connection properties and copy the connection string to the clipboard.

A connection string for Marketo will typically look like the following:


Use the configured JDBC URL to obtain an instance of the DAO interface. The particular method shown below will open a handle bound to the instance, so the instance needs to be closed explicitly to release the handle and the bound JDBC connection.

DBI dbi = new DBI("jdbc:marketo:Schema=REST;RESTEndpoint=;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;"); MyLeadsDAO dao =; //do stuff with the DAO dao.close();

Read Marketo Data

With the connection open to Marketo, simply call the previously defined method to retrieve data from the Leads entity in Marketo.

//disply the result of our 'find' method String annualRevenue = dao.findAnnualRevenueByCountry("U.S.A."); System.out.println(annualRevenue);

Write Marketo Data

It is also simple to write data to Marketo, using the previously defined method.

//add a new entry to the Leads entity dao.insert(newCountry, newAnnualRevenue);

Since the JDBI library is able to work with JDBC connections, you can easily produce a SQL Object API for Marketo by integrating with the CData JDBC Driver for Marketo. Download a free trial and work with live Marketo data in custom Java applications today.