Skip to main content

Marketo

Integrating Marketo with Osano​

Connecting to Marketo​

In order for Osano to discover data stored in your systems, we must connect to those data providers via an API. We require, at minimum, read-only access to establish a connection to these providers. Each provider you connect may require different information. Please see the linked vendor documentation for instructions on where and how to obtain this data.

Setup​

An admin must create a Bearer Token with the required scopes (Read-Only Person, Read-Only Asset, Access User Management Api, Access Users) and enter that information in Osano to establish a connection via API Key.

Authenticated Roles​

admin

Authentication Actions​

  • Bearer Token -Instructions for obtaining your Marketo API Key ( also known as Authentication Token) and the API URL ( also known as endpoint URL)

  • For example, if the endpoint URL reads https://100-AEK-913.mktorest.com/rest/v1/lead/{id}.json, input https://100-AEK-913.mktorest.com.

  • Required Scopes

    • Read-Only Person
    • Read-Only Asset
    • Access User Management Api
    • Access Users
      • Marketo has some predefined scopes groups that you can use to manage permissions. The above are the scopes that you need to provide to Osano, which already encompasses the 4 required permissions.

Marketo Permission 1 Marketo Permission 2

Authentication Methods​

  • API Key

Authorization header with the api key as the bearer token

Core Functionality​

  • Data Discovery
  • User Search
  • Data Deletion

Base URL​

https://developers.marketo.com/rest-api/

  • email
  • name
  • phoneNumber
  • address
  • birthday
  • userId

Endpoints​

Used for data discovery

  • GET rest/v1/leads.json
  • GET rest/v1/leads/{{lead ID}}/listMembership.json
  • GET rest/v1/leads/{{lead ID}}/programMembership.json
  • GET rest/v1/leads/{{lead ID}}/smartCampaignMembership.json
  • GET userservice/management/v1/users/{{user ID}}/user.json
  • GET userservice/management/v1/users/{{user ID}}/roles.json

Used for user search

  • GET rest/v1/leads.json?filterType=email&filterValues={{email}}
  • GET rest/v1/leads/{{lead ID}}/listMembership.json
  • GET rest/v1/leads/{{lead ID}}/programMembership.json
  • GET rest/v1/leads/{{lead ID}}/smartCampaignMembership.json
  • GET userservice/management/v1/users/{{user ID}}/user.json
  • GET userservice/management/v1/users/{{user ID}}/roles.json

Last Modified: 2025-03-28