Skip to main content

Marketo

Marketo Integration Guide

Overview

This guide explains what Bridged needs from your Marketo instance to connect a contact/attendee list and generate personalised content per contact. Bridged does not send or broadcast emails through Marketo — your team keeps full control of scheduling and delivery. Bridged writes a personalisation field to each contact, which your team then references inside your own Marketo email template.

Marketo authenticates via REST API using OAuth 2.0 (client credentials). Access is provisioned through a Custom Service in Marketo's LaunchPoint.

Prerequisites

Before starting, ensure you have:

  • Administrator access to your Marketo instance

  • Permission to create Roles, Users, and LaunchPoint services

  • The list or smart list you want Bridged to read contacts from

Step 1: Create an API-Only Role

  1. Log in to Marketo and go to Admin → Users & Roles → Roles.

  2. Click New Role.

  3. Give it a descriptive name (e.g. Bridged Integration Role).

  4. Under the Access API permission group, assign:

    • Read-Write Lead (required so Bridged can write the personalisation field back to each contact)

    • Read-Only Lead (if you'd prefer read-only access while testing)

  5. Click Create.

Step 2: Create an API-Only User

  1. Go to Admin → Users & Roles → Users and click Invite New User.

  2. Enter a descriptive name and email (e.g. bridged-api@yourdomain.com — it does not need to be a live inbox).

  3. Check API Only.

  4. Assign the role created in Step 1.

  5. Click Send to create the user.

Step 3: Create a Custom Service in LaunchPoint

  1. Go to Admin → Integration → LaunchPoint.

  2. Click New → New Service.

  3. Enter a Display Name (e.g. Bridged).

  4. Under Service, select Custom.

  5. Under API Only User, select the user created in Step 2.

  6. Click Create.

  7. Click View Details on the new service and record the:

    • Client ID

    • Client Secret

Important: Store the Client Secret securely — it will not be shown again.

Step 4: Retrieve Your REST API Endpoint

  1. Go to Admin → Integration → Web Services.

  2. Under the REST API section, copy the Endpoint URL (format: https://XXX-XXX-XXX.mktorest.com/).

Step 5: Create the Personalisation Field

Bridged writes generated personalisation content to a custom field on the Lead record, which you then insert into your email template as a token.

  1. Go to Admin → Field Management.

  2. Click New Custom Field.

  3. Set the field type to Rich Text (or Text Area).

  4. Name it something identifiable, e.g. Bridged_Personalized_Content.

  5. Save the field.

Step 6: Confirm List Access

Identify the list or smart list of contacts you want included, and note its name. Bridged will read from this list to generate personalised content per contact.

What to Share with Bridged

Send the following to your Bridged contact:

  • Client ID

  • Client Secret

  • REST API Endpoint URL

  • List / smart list name to use

  • Custom field name created in Step 5

Rate Limits

Most Marketo subscriptions are allocated 50,000 REST API calls per day, with a shared limit of roughly 100 calls per 20 seconds. Bridged operates within these limits automatically.

Support

For integration support, contact your Bridged account manager or email support@bridged.media.