Adobe Marketo Engage REST API

marketo.com · Company

Company OAuth2 Paid Technology Financial Services Retail & E-Commerce Marketing CRM Enterprise

REST API for Adobe Marketo Engage — the leading B2B marketing automation platform. Manage leads, companies, activities, campaigns, email programs, and custom objects. Heavily used for marketing-to-sales integration workflows.

Authentication

OAuth2 OAuth2 client credentials. Create a LaunchPoint API service in Marketo Admin → LaunchPoint to get client_id and client_secret. Token endpoint includes Munchkin ID.

Sample Requests

GET Get access token

Exchanges client credentials for an access token. Token expires in 3600 seconds.

https://{munchkinId}.mktorest.com/rest/v1/identity/oauth/token?client_id=YOUR_CLIENT_ID&grant_type=client_credentials&client_secret=YOUR_CLIENT_SECRET

Hover any highlighted part to learn what it does

curl -X GET "https://{munchkinId}.mktorest.com/rest/v1/identity/oauth/token?client_id=YOUR_CLIENT_ID&grant_type=client_credentials&client_secret=YOUR_CLIENT_SECRET"

import requests
params = {
    "client_id": "YOUR_CLIENT_ID",
    "grant_type": "client_credentials",
    "client_secret": "YOUR_CLIENT_SECRET"
}
response = requests.get(
    "https://{munchkinId}.mktorest.com/rest/v1/identity/oauth/token",
    params=params,
)
print(response.json())

const url = new URL('https://{munchkinId}.mktorest.com/rest/v1/identity/oauth/token');
url.searchParams.set('client_id', 'YOUR_CLIENT_ID');
url.searchParams.set('grant_type', 'client_credentials');
url.searchParams.set('client_secret', 'YOUR_CLIENT_SECRET');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://{munchkinId}.mktorest.com/rest/v1/identity/oauth/token")
	q := baseURL.Query()
	q.Set("client_id", "YOUR_CLIENT_ID")
	q.Set("grant_type", "client_credentials")
	q.Set("client_secret", "YOUR_CLIENT_SECRET")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://{munchkinId}.mktorest.com/rest/v1/identity/oauth/token")
uri.query = URI.encode_www_form({
  "client_id" => "YOUR_CLIENT_ID",
  "grant_type" => "client_credentials",
  "client_secret" => "YOUR_CLIENT_SECRET"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://{munchkinId}.mktorest.com/rest/v1/identity/oauth/token?" . http_build_query([
    "client_id" => "YOUR_CLIENT_ID",
    "grant_type" => "client_credentials",
    "client_secret" => "YOUR_CLIENT_SECRET"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Get leads by filter

Returns lead records matching a filter. filterType can be email, id, or any indexed field.

https://{munchkinId}.mktorest.com/rest/v1/leads.json?fields=email,firstName,lastName,company&filterType=email&filterValues=[email protected]

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

Authorization

Bearer YOUR_ACCESS_TOKEN

curl -X GET "https://{munchkinId}.mktorest.com/rest/v1/leads.json?fields=email%2CfirstName%2ClastName%2Ccompany&filterType=email&filterValues=john%40example.com" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

import requests
params = {
    "fields": "email,firstName,lastName,company",
    "filterType": "email",
    "filterValues": "[email protected]"
}
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
response = requests.get(
    "https://{munchkinId}.mktorest.com/rest/v1/leads.json",
    params=params,
    headers=headers,
)
print(response.json())

const url = new URL('https://{munchkinId}.mktorest.com/rest/v1/leads.json');
url.searchParams.set('fields', 'email,firstName,lastName,company');
url.searchParams.set('filterType', 'email');
url.searchParams.set('filterValues', '[email protected]');

const response = await fetch(url, {
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://{munchkinId}.mktorest.com/rest/v1/leads.json")
	q := baseURL.Query()
	q.Set("fields", "email,firstName,lastName,company")
	q.Set("filterType", "email")
	q.Set("filterValues", "[email protected]")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("Authorization", "Bearer YOUR_ACCESS_TOKEN")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://{munchkinId}.mktorest.com/rest/v1/leads.json")
uri.query = URI.encode_www_form({
  "fields" => "email,firstName,lastName,company",
  "filterType" => "email",
  "filterValues" => "[email protected]"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer YOUR_ACCESS_TOKEN"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://{munchkinId}.mktorest.com/rest/v1/leads.json?" . http_build_query([
    "fields" => "email,firstName,lastName,company",
    "filterType" => "email",
    "filterValues" => "[email protected]"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "Authorization: Bearer YOUR_ACCESS_TOKEN"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

Requires Adobe Marketo Engage subscription
Go to Marketo Admin → LaunchPoint → New Service to create API credentials
Your Munchkin ID is in Marketo Admin → Integration → Munchkin
Token URL: https://{munchkinId}.mktorest.com/identity/oauth/token
In Postman, first call the token endpoint, then use the access_token as Bearer
Tokens expire in 1 hour — implement refresh logic for long-running integrations
Rate limits: 50,000 API calls/day by default

What can you build with Adobe Marketo Engage REST API?

Adobe Marketo Engage REST API is a Company API. Developers commonly use company APIs for:

enriching CRM records with company firmographics
building lead-generation and prospecting tools
verifying business identity and registration details
monitoring competitors and market intelligence
powering B2B data enrichment pipelines

OAuth 2.0. OAuth lets your app act on behalf of a user. You redirect them to authorise access, receive a token, then use that token in requests. Best for accessing user-owned data. Adobe Marketo Engage REST API is a paid API — check the provider's pricing page before building a production integration.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗