---
title: "How do I configure the Marketo integration in Chat?"
source_url: https://help.chilipiper.com/hc/en-us/articles/49822563653779-How-do-I-configure-the-Marketo-integration-in-Chat
article_id: 49822563653779
updated_at: 2026-07-24T18:55:56Z
content_hash: ccfedc4c
---

## Who can use this feature?

Available on All Products or Experiences

Available to Only Admins

[Billing Center](https://fire.chilipiper.com/fire/admin/billing/overview) [Get a Demo](https://www.chilipiper.com/request-demo?utm_source=zendesk&utm_medium=help-center&utm_campaign=chili-hub)

The Marketo integration enables marketing teams to sync Chat data directly to Marketo. You can create and update Leads, log Chat and Meeting activities as Custom Activities, use Marketo Lead and Company fields in routing rules, and map Chili Piper data fields to Marketo fields.

#### Table of Contents

- [How to Set Up the Marketo Connection](#how-to-set-up-the-marketo-connection)

- [Marketo Permissions Required](#marketo-permissions-required)

- [Data Field Mapping](#data-field-mapping)

- [Using Marketo Fields in Rules](#using-marketo-fields-in-rules)

- [Marketo-Related Nodes in Journeys](#marketo-related-nodes-in-journeys)
[Update or Create Lead Node](#update-or-create-lead-node)

- [Update Field Node](#update-field-node)

- [Log Chat Activity Node](#log-chat-activity-node)

- [Log Meeting Activity Node](#log-meeting-activity-node)

- [Limitations](#limitations)

## How to Set Up the Marketo Connection

Setting up the Marketo integration requires three pieces of information from your Marketo instance: a **Client ID**, a **Client Secret**, and an **Endpoint URL**.

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

- In Marketo, go to **Admin** > **Integration** > **LaunchPoint**.

- Select **New** > **New Service**.

- Set the Service type to **Custom**.

- Create or select an **API-Only user** for the service.

- Copy the **Client ID** and **Client Secret** from the service details.

![](https://help.chilipiper.com/hc/article_attachments/49822588366227)![](https://help.chilipiper.com/hc/article_attachments/49822563624851)
### Step 2: Get Your Endpoint URL

- In Marketo, go to **Admin** > **Integration** > **Web Services**.

- Under the **REST API** section, copy the **Endpoint URL** (e.g. https://xxx-xxx-xxx.mktorest.com). Do not include the /rest suffix – Chili Piper adds this automatically.

![](https://help.chilipiper.com/hc/article_attachments/49822588371987)
### Step 3: Connect in Chili Piper

- In Chili Piper, go to **Command Center** > **Integrations**.

- Find the **Marketo** integration card and select **Connect**.

- Enter the **Client ID**, **Client Secret**, and **Endpoint URL**.

- Select **Connect**.

![](https://help.chilipiper.com/hc/article_attachments/49822588371987)If the connection is successful:

- Two custom activity types are automatically created in your Marketo instance: **New Chili Piper Chat** and **New Chili Piper Meeting**;

- The integration card status changes to **Connected**.

![](https://help.chilipiper.com/hc/article_attachments/51290036179603)If the connection fails, an error message is displayed with the reason. Verify that all required permissions are configured (see next section) and try again.

> **Note:** All connection and reconnection attempts are logged for troubleshooting purposes.

## Marketo Permissions Required

The Marketo API user **must** have the following scopes assigned:

- Read-Only Lead;

- Read-Write Lead;

- Read-Only Company;

- Read-Write Company;

- Read-Only Opportunity;

- Read-Write Opportunity;

- Read-Only Sales Person;

- Read-Only Custom Object;

- Read-Write Custom Object;

- Read-Only Activity;

- Read-Write Activity;

- Read-Only Program Member;

- Read-Write Program Member;

- Read-Only Custom Object Metadata;

- Read-Write Custom Object Metadata;

- Read-Only Metadata;

- Read-Write Metadata.

Marketo uses key-based authentication. If you need to add missing permissions after connecting, you can do so in your Marketo admin panel without disconnecting and reconnecting the integration in Chili Piper.

> ⚠️ **Warning:** Chili Piper's connection test only checks basic API access – it does not verify every permission scope. This means the connection can show as successful even if a required scope (like Read-Write Activity) is missing. The missing permission will only cause errors later, when a journey tries to use it. Assign all scopes listed above before connecting.

## Data Field Mapping

Once Marketo is connected, a **Mapping to Marketo** section appears in the Data Fields configuration, below the existing Mapping to Salesforce section.

### Where to Find It

- Go to **Command Center** > **Data Fields**.

- Select **Person** or **Company** objects.

- Scroll below the Salesforce mapping to find the **Mapping to Marketo** section.

### Default Mapped Fields

#### Person (Lead) Fields:

Chili Piper Field
Marketo API Name

First Name
`firstName`

Last Name
`lastName`

Email
`email`

Job Title
`title`

Phone
`phone`

City
`city`

Country
`country`

US State
`state`

 

#### Company Fields:

Chili Piper Field
Marketo API Name

City
`billingCity`

Country
`billingCountry`

Company Name
`company`

Company Phone
`mainPhone`

Company Size
`numberOfEmployees`

Website
`website`

Revenue
`annualRevenue`

### Adding Custom Mappings

- In the Mapping to Marketo section, select **Add Mapping**.

- A sidebar panel opens with three fields:

**Source** – Select Marketo.

- **Object** – Select Lead or Company.

- **Field** – Select the Marketo field to map to.

- Select **Save**.

- Select **Publish** to apply the changes.

### Syncing New Fields

Marketo fields are fetched on demand each time you open the Data Fields page or the rule builder. If you add new custom fields in Marketo, they will appear automatically the next time you load these pages.

> **Note:** Field type validation is enforced. Non-compatible Marketo field types are hidden from the field picker. For example, a phone field cannot be mapped to a picklist field.

## Using Marketo Fields in Rules

Marketo Lead and Company fields are available as conditions in any rule within a journey.

### How to Add a Marketo Condition

- Open a rule in the rule builder.

- In the Object List, find the **Marketo** section.

- Select **Lead** or **Lead > Company** as the object.

- Select the field you want to evaluate.

- Choose an operator and set a value.

Marketo does not expose picklist values via the API. For picklist-type fields, you must enter the value manually.

You can combine Marketo conditions with Salesforce and Chili Data conditions in the same rule. There are no restrictions on mixing data sources.

![](https://help.chilipiper.com/hc/article_attachments/49822588374291)
## Marketo-Related Nodes in Journeys

Marketo action nodes appear under a dedicated **Marketing Automation** section in the action node menu. These nodes are only visible when the Marketo integration is connected.

> ⚠️ **Warning:** All Marketo action nodes require the visitor's email to be captured earlier in the journey (for example, via a question node or form). If the email has not been captured on the same path or a parent path, a validation error is displayed when publishing.
![](https://help.chilipiper.com/hc/article_attachments/49822563629971)
### Update or Create Lead Node

This node creates a new Lead in Marketo, updates an existing one, or both. It uses email-based deduplication – if a Lead with the same email already exists, it is updated rather than duplicated.

#### Configuration

Select one of the following modes:

- **Update existing Lead only** – Update a matched Lead with the latest data. Do not create a new Lead.

- **Update existing Lead or create new ones** – Update a matched Lead with the latest data. Create a new Lead if no match is found.

- **Create a new Lead only** – Create a new Lead when no matched Lead is found.

Optionally, select **Add to List** to add the Lead to a static list. All active static lists in your Marketo instance are available in the dropdown.

The node preview displays the selected mode and list.

![](https://help.chilipiper.com/hc/article_attachments/49822588375827)
> **Note:** Add to Program is not available in this node.

### Update Field Node

This node updates Lead field values in Marketo directly from the journey. You can update multiple fields in the same node.

#### Configuration

- Select the **Object** (Lead).

- Select the **Field** you want to update.

- Set the **Value**.

- Optionally add more fields to update in the same node.

![](https://help.chilipiper.com/hc/article_attachments/49822588376979)
> **Note:** Company fields are not yet available in the Update Field node. Currently, only Lead fields can be updated.

### Log Chat Activity Node

This node logs a **New Chili Piper Chat** custom activity on the Lead's Activity Log in Marketo.

Marketing teams can use this activity as a trigger in Smart Campaigns, for lead scoring, and in reports.

#### Configuration

- **Delay before Logging Activity** – Set the number of minutes to wait after the last message before logging the activity. The default is five minutes.

The chat transcript is always included in the activity.

Field
Description

Journey Name
The name of the journey in Chili Piper

Person ID
The ID of the lead who started the chat

Chat Log URL
A link to the chat log in Chili Piper

Chat Transcript
The transcript of the conversation

Target URL
The page URL where the chat started

Closed By
The email of the user who closed the chat, if applicable

![](https://help.chilipiper.com/hc/article_attachments/49822588380819)In Marketo, this activity appears with the filter name **New Chili Piper Chat Started** and the trigger name **New Chili Piper Chat**.

### Log Meeting Activity Node

This node logs a **New Chili Piper Meeting** custom activity on the Lead's Activity Log in Marketo when a meeting is booked via Chat.

This node appears in the action node menu but is grayed out until placed on the **Scheduled** path after a **Display Calendar** node.

Field
Description

Booking Source
The source of the booking (e.g. "chat")

Journey Name
The name of the journey in Chili Piper

Person ID
The ID of the lead who started the chat

Meeting Type
The Meeting Type name in Chili Piper

Booked By
The user who booked the meeting

Team Name
The name of the Team, Distribution, or Individual

Rule Name
The rule that was matched before the meeting was booked

![](https://help.chilipiper.com/hc/article_attachments/49822588381203)In Marketo, this activity appears with the filter name **New Chili Piper Meeting Scheduled** and the trigger name **New Chili Piper Meeting**.

## Limitations

- Marketo fields are fetched on demand, not synced in the background. New fields appear when you reload the Data Fields page or rule builder;

- All Marketo action nodes require the visitor's email to be captured first in the journey;

- Cookie-based visitor matching (using the Marketo _mkto_trk cookie) is not available;

- Company fields are not yet available in the Update Field node. Only Lead fields can be updated;

- Add to Program is not yet available as a journey node;

- Connection verification does not validate individual permission scopes. If a required scope is missing, the connection will succeed but that specific operation will fail at runtime.