> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bondata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Marketo

> Connect BonData to Adobe Marketo Engage for leads, activities, and campaign data

Adobe Marketo Engage is a marketing automation platform for lead management, email marketing, and multi-channel campaign orchestration. With BonData, you can connect to your Marketo instance to read, enrich, and sync your marketing data - including leads, activities, and program performance - within Agent workflows.

## Marketo REST API Setup

Marketo authenticates through a Custom Service in LaunchPoint. You'll need a **Client ID**, a **Client Secret**, and your instance **Endpoint URL** (the Munchkin-based REST endpoint).

### Step 1: Create a Custom Service in LaunchPoint

1. Log in to [Marketo](https://login.marketo.com/) as an admin
2. Go to **Admin** → **Integration** → **LaunchPoint**
3. Click **New** → **New Service**
4. Set **Service** to **Custom**, give it a display name (e.g. `BonData`)
5. Select an **API Only** user as the associated user, then click **Create**

<Tip>
  Create the API Only user first under **Admin** → **Users & Roles**, assigning it a role with **Access API** permissions (Read-Only Lead, Read-Only Activity, etc.). Marketo requires the service to be tied to an API user.
</Tip>

### Step 2: Retrieve Your Credentials and Endpoint

1. On the LaunchPoint page, click **View Details** next to your new service
2. Copy the **Client Id** and **Client Secret**
3. Go to **Admin** → **Integration** → **Web Services**
4. Under **REST API**, copy your **Endpoint** URL - it looks like `https://123-ABC-456.mktorest.com/rest`

<Note>
  The numeric prefix in your endpoint (e.g. `123-ABC-456`) is your Munchkin ID. Use the full REST endpoint, not the Identity or SOAP URL.
</Note>

### Step 3: Enter Credentials in BonData

1. In BonData, navigate to **Integrations** and select **Marketo**
2. Enter your **Client ID**, **Client Secret**, and **Endpoint URL**
3. Click **Connect**

BonData exchanges your credentials for a short-lived access token and refreshes it automatically.

## Required Fields

| Field         | Description                                                                                          |
| ------------- | ---------------------------------------------------------------------------------------------------- |
| Client ID     | Client Id from your LaunchPoint Custom Service                                                       |
| Client Secret | Client Secret from your LaunchPoint Custom Service                                                   |
| Endpoint URL  | REST endpoint from Admin → Integration → Web Services (e.g. `https://123-ABC-456.mktorest.com/rest`) |

## Available Data

Once connected, BonData can sync the following Marketo data:

* **Leads** - Person records with standard and custom fields
* **Activities** - Lead activity history such as email opens, clicks, form fills, and page visits
* **Programs** - Marketing programs and their metadata
* **Campaigns** - Batch and trigger smart campaigns
* **Lists** - Static lists and their membership
* **Opportunities** - Sales opportunities and opportunity roles synced into Marketo
* **Companies** - Company records associated with leads