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.

Required Fields​

  • API Key
  • API URL

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.

Base URL​

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

Auth​

  • API Key
  • OAuth

Authorization header with the api key as the bearer token

  • Email
  • Name
  • Phone Number
  • Address
  • Date of Birth
  • User ID

Scopes​

Marketo has some predefined scopes groups that you can use to manage permissions. The following are the scopes that you need to provide to Osano, which already encompasses the 4 required permissions:

Marketo Permission 1 Marketo Permission 2

  • Read-Only Person
  • Read-Only Asset
  • Access User Management Api
  • Access Users

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