Adobe Marketo Engage Component
Manage Marketo records
Component key: marketoDescription
Adobe Marketo allows you to leverage rich behavioral data, built-in intelligence, and sophisticated journey flows to identify, engage, and accelerate your best opportunities to orchestrate your buyer's journeys.
The Marketo API does have fairly restrictive rate limits, so care must be taken to stay under those limits. Please see the Best Practices Documentation for more information on rate limits.
Connections
Marketo OAuth 2.0
To make API requests of Marketo on behalf of your customers you need to create a Custom Service using the Marketo Admin Portal. Follow the steps outlined in the Marketo Documentation. Be sure to note the Client ID and Client Secret values, as these will be important when using the Marketo Connection as part of your Integration.
Actions
Delete Companies
Delete one or more Companies. | key: deleteCompanies
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"id": 1234,
"status": "deleted"
},
{
"seq": 1,
"id": 56456,
"status": "deleted"
},
{
"seq": 2,
"status": "skipped",
"reasons": [
{
"code": "1013",
"message": "Record not found"
}
]
}
]
}
}
Delete Custom Objects
Delete one or more Custom Objects. | key: deleteCustomObjects
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb",
"status": "deleted"
},
{
"seq": 1,
"marketoGUID": "da42707c-4dc4-4fc1-9fef-f30a3017240a",
"status": "deleted"
},
{
"seq": 2,
"status": "skipped",
"reasons": [
{
"code": "1013",
"message": "Object not found"
}
]
}
]
}
}
Delete Leads
Delete one or more Leads by their Marketo id. | key: deleteLeads
{
"data": {
"requestId": "3608#16664333670",
"result": [
{
"id": 235,
"status": "deleted"
},
{
"id": 766,
"status": "deleted"
}
],
"success": true
}
}
Delete Named Accounts
Delete one or more Named Accounts. | key: deleteNamedAccounts
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb",
"status": "deleted"
},
{
"seq": 1,
"id": "dff23271-f996-47d7-984f-f2676861b5fc",
"status": "deleted"
},
{
"seq": 2,
"status": "skipped",
"reasons": [
{
"code": "1013",
"message": "Record not found"
}
]
}
]
}
}
Delete Opportunities
Delete one or more Opportunities. | key: deleteOpportunities
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb",
"status": "deleted"
},
{
"seq": 1,
"marketoGUID": "cff23271-f996-47d7-984f-f2676861b5fb",
"status": "deleted"
}
]
}
}
Delete Sales Persons
Delete one or more Sales Persons. | key: deleteSalesPersons
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"id": 56343,
"status": "deleted"
},
{
"seq": 1,
"id": 53453,
"status": "deleted"
},
{
"seq": 2,
"status": "skipped",
"reasons": [
{
"code": "1013",
"message": "Record not found"
}
]
}
]
}
}
Describe Company
Returns metadata about companies and the fields available for interaction via the API. | key: describeCompany
{
"data": {
"success": true,
"requestId": "5847#14d44113ad7",
"result": [
{
"name": "Company",
"description": "Company object",
"createdAt": "2015-05-11T17:11:32Z",
"updatedAt": "2015-05-11T17:11:32Z",
"idField": "id",
"dedupeFields": [
"externalCompanyId"
],
"searchableFields": [
[
"externalCompanyId"
],
[
"id"
],
[
"company"
]
],
"fields": [
{
"name": "createdAt",
"displayName": "Created At",
"dataType": "datetime",
"updateable": false
},
{
"name": "externalCompanyId",
"displayName": "External Company Id",
"dataType": "string",
"length": 100,
"updateable": false
},
{
"name": "id",
"displayName": "Id",
"dataType": "integer",
"updateable": false
},
{
"name": "updatedAt",
"displayName": "Updated At",
"dataType": "datetime",
"updateable": false
},
{
"name": "annualRevenue",
"displayName": "Annual Revenue",
"dataType": "currency",
"updateable": true
},
{
"name": "company",
"displayName": "Company Name",
"dataType": "string",
"length": 255,
"updateable": true
}
]
}
]
}
}
Describe Custom Object
Returns metadata regarding a given custom object. | key: describeCustomObject
{
"data": {
"requestId": "185d6#14b51985ff0",
"success": true,
"result": [
{
"name": "Car",
"displayName": "Car",
"description": "Car owner",
"createdAt": "2015-02-03T22:36:23Z",
"updatedAt": "2015-02-03T22:36:24Z",
"idField": "marketoGUID",
"dedupeFields": [
"vin"
],
"searchableFields": [
[
"vin"
],
[
"marketoGUID"
],
[
"siebelId"
]
],
"relationships": [
{
"field": "siebelId",
"type": "parent",
"object": {
"name": "Lead",
"field": "siebelId"
}
}
],
"fields": [
{
"name": "marketoGUID",
"displayName": "Marketo GUID",
"dataType": "string",
"length": 36,
"updateable": false
},
{
"name": "createdAt",
"displayName": "Created At",
"dataType": "datetime",
"updateable": false
},
{
"name": "updatedAt",
"displayName": "Updated At",
"dataType": "datetime",
"updateable": false
},
{
"name": "vin",
"displayName": "VIN",
"description": "Vehicle Identification Number",
"dataType": "string",
"length": 36,
"updateable": false
},
{
"name": "siebelId",
"displayName": "External Id",
"description": "External Id",
"dataType": "string",
"length": 36,
"updateable": true
},
{
"name": "make",
"displayName": "Make",
"dataType": "string",
"length": 36,
"updateable": true
},
{
"name": "model",
"displayName": "Model",
"description": "Vehicle Model",
"dataType": "string",
"length": 255,
"updateable": true
},
{
"name": "year",
"displayName": "Year",
"dataType": "integer",
"updateable": true
},
{
"name": "color",
"displayName": "Color",
"description": "Vehicle color",
"dataType": "String",
"length": 255,
"updateable": true
}
]
}
]
}
}
Describe Lead
Returns metadata about lead objects in the target instance, including a list of all fields available for interaction via the APIs. | key: describeLead
{
"data": {
"requestId": "37ca#1475b74e276",
"success": true,
"result": [
{
"id": 2,
"displayName": "Company Name",
"dataType": "string",
"length": 255,
"rest": {
"name": "company",
"readOnly": false
},
"soap": {
"name": "Company",
"readOnly": false
}
}
]
}
}
Describe Named Account
Returns metadata about Named Accounts and the fields available for interaction via the API. | key: describeNamedAccount
{
"data": {
"requestId": "d65e#156c27ac57d",
"result": [
{
"name": "Named Account",
"description": "Marketo standard account attribute map",
"createdAt": "2016-08-18T20:16:41Z",
"updatedAt": "2016-08-18T20:16:41Z",
"idField": "marketoGUID",
"dedupeFields": [
"name"
],
"searchableFields": [
[
"marketoGUID"
],
[
"annualRevenue"
],
[
"city"
],
[
"country"
],
[
"domainName"
],
[
"industry"
],
[
"logoUrl"
],
[
"membershipCount"
],
[
"name"
],
[
"numberOfEmployees"
],
[
"opptyAmount"
],
[
"opptyCount"
],
[
"score1"
],
[
"score2"
],
[
"score3"
],
[
"score4"
],
[
"score5"
],
[
"sicCode"
],
[
"state"
]
],
"fields": [
{
"name": "marketoGUID",
"displayName": "Marketo GUID",
"dataType": "string",
"length": 36,
"updateable": false
},
{
"name": "annualRevenue",
"displayName": "annualRevenue",
"dataType": "currency",
"updateable": true
},
{
"name": "city",
"displayName": "city",
"dataType": "string",
"length": 255,
"updateable": true
},
{
"name": "country",
"displayName": "country",
"dataType": "string",
"length": 255,
"updateable": true
}
]
}
],
"success": true
}
}
Describe Opportunities
Returns metadata about Opportunities and the fields available for interaction via the API. | key: describeOpportunities
{
"data": {
"requestId": "185d6#14b51985ff0",
"success": true,
"result": [
{
"name": "opportunity",
"displayName": "Opportunity",
"createdAt": "2015-02-03T22:36:23Z",
"updatedAt": "2015-02-03T22:36:24Z",
"idField": "marketoGUID",
"dedupeFields": [
"externalOpportunityId"
],
"searchableFields": [
[
"externalOpportunityId"
],
[
"marketoGUID"
]
],
"fields": [
{
"name": "marketoGUID",
"displayName": "Marketo GUID",
"dataType": "string",
"length": 36,
"updateable": false
},
{
"name": "createdAt",
"displayName": "Created At",
"dataType": "datetime",
"updateable": false
},
{
"name": "updatedAt",
"displayName": "Updated At",
"dataType": "datetime",
"updateable": false
},
{
"name": "externalOpportunityId",
"displayName": "External Opportunity Id",
"dataType": "string",
"length": 50,
"updateable": false
}
]
}
]
}
}
Describe Sales Person
Returns metadata about Sales Persons and the fields available for interaction via the API. | key: describeSalesPerson
{
"data": {
"requestId": "185d6#14b51985ff0",
"success": true,
"result": [
{
"name": "SalesPerson",
"createdAt": "2015-02-03T22:36:23Z",
"updatedAt": "2015-02-03T22:36:24Z",
"idField": "id",
"dedupeFields": [
"externalSalesPersonId"
],
"searchableFields": [
[
"email"
],
[
"id"
],
[
"externalSalesPersonId"
]
],
"fields": [
{
"name": "id",
"displayName": "Marketo Id",
"dataType": "integer",
"updateable": false
},
{
"name": "createdAt",
"displayName": "Created At",
"dataType": "datetime",
"updateable": false
},
{
"name": "updatedAt",
"displayName": "Updated At",
"dataType": "datetime",
"updateable": false
},
{
"name": "email",
"displayName": "Email",
"dataType": "string",
"length": 255,
"updateable": false
},
{
"name": "externalSalesPersonId",
"displayName": "External Sales Person Id",
"dataType": "string",
"length": 255,
"updateable": false
}
]
}
]
}
}
Get Companies By Filter
Retrieves company records from the destination instance based on the submitted filter. | key: getCompaniesByFilter
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"id": 3433,
"externalCompanyId": "19UYA31581L000000",
"company": "Google"
},
{
"seq": 1,
"id": 5345,
"externalCompanyId": "29UYA31581L000000",
"company": "Yahoo"
}
]
}
}
Get Custom Objects By Filter
Retrieves a list of custom objects records based on filter and set of values. | key: getCustomObjectsByFilter
{
"data": {
"requestId": "12951#15699db5c97",
"result": [
{
"id": 318581,
"updatedAt": "2016-05-17T22:11:45Z",
"lastName": "Lincoln",
"email": "abe@usa.gov",
"createdAt": "2015-03-17T00:18:40Z",
"firstName": "Abraham"
},
{
"id": 318592,
"updatedAt": "2016-05-17T22:20:51Z",
"lastName": "Washington",
"email": "george@usa.gov",
"createdAt": "2015-04-06T16:29:21Z",
"firstName": "George"
}
],
"success": true
}
}
Get Lead By Id
Retrieves a single lead record through its Marketo id. | key: getLeadById
{
"data": {
"requestId": "10226#14d3049e51b",
"success": true,
"result": [
{
"id": 318581,
"updatedAt": "2015-05-07T11:47:30-08:00",
"lastName": "Doe",
"email": "jdoe@marketo.com",
"createdAt": "2015-05-01T16:47:30-08:00",
"firstName": "John"
}
]
}
}
Get Leads By Filter
Returns a list of up to 300 leads based on a list of values in a particular field. | key: getLeadsByFilter
{
"data": {
"requestId": "12951#15699db5c97",
"result": [
{
"id": 318581,
"updatedAt": "2016-05-17T22:11:45Z",
"lastName": "Lincoln",
"email": "abe@usa.gov",
"createdAt": "2015-03-17T00:18:40Z",
"firstName": "Abraham"
},
{
"id": 318592,
"updatedAt": "2016-05-17T22:20:51Z",
"lastName": "Washington",
"email": "george@usa.gov",
"createdAt": "2015-04-06T16:29:21Z",
"firstName": "George"
}
],
"success": true
}
}
Get Named Accounts By Filter
Retrieves Named Account records from the destination instance based on the submitted filter. | key: getNamedAccountsByFilter
{
"data": {
"requestId": "6dac#157d4ddc9d7",
"result": [
{
"seq": 0,
"marketoGUID": "16efafdd-0148-4ea7-8782-f451d7c6345d",
"createdAt": "2016-10-17T22:49:04Z",
"name": "Google",
"updatedAt": "2016-10-17T22:49:04Z"
},
{
"seq": 1,
"marketoGUID": "44d62353-7f9d-4d43-b9cc-7ef0f7a09137",
"createdAt": "2016-10-17T22:49:04Z",
"name": "Yahoo",
"updatedAt": "2016-10-17T22:49:04Z"
}
],
"success": true
}
}
Get Opportunities By Filter
Retrieves Opportunity records from the destination instance based on the submitted filter. | key: getOpportunitiesByFilter
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fa ",
"externalOpportunityId": "19UYA31581L000000",
"name": "Chairs",
"description": "Chairs",
"amount": "1604.47",
"source": "Inbound Sales Call/Email"
},
{
"seq": 1,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fc ",
"externalOpportunityId": "29UYA31581L000000",
"name": "Big Dog Day Care-Phase12",
"description": "Big Dog Day Care-Phase12",
"amount": "1604.47",
"source": "Email"
}
]
}
}
Get Sales Persons By Filter
Retrieves Sales Person records from the destination instance based on the submitted filter. | key: getSalesPersonsByFilter
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"id": 53453,
"externalSalesPersonId": "sam@test.com",
"createdAt": "2015-02-03T22:36:23Z",
"updatedAt": "2015-02-03T22:36:23Z"
},
{
"seq": 1,
"id": 53454,
"externalSalesPersonId": "david@test.com",
"createdAt": "2015-02-03T22:36:23Z",
"updatedAt": "2015-02-03T22:36:23Z"
}
]
}
}
Get Searchable Lead Fields
Returns list of searchable fields on lead objects in the target instance. | key: getSearchableLeadFields
{
"data": {
"requestId": "string",
"result": [
{
"name": "string",
"searchableFields": [
[
"string"
]
],
"fields": [
{
"name": "string",
"displayName": "string",
"dataType": "string",
"length": 0,
"updateable": true,
"crmManaged": true
}
]
}
]
}
}
List Custom Objects
Returns a list of Custom Object types available in the target instance, along with id and deduplication information for each type. | key: listCustomObjects
{
"data": {
"requestId": "185d6#14b51985ff0",
"success": true,
"result": [
{
"name": "Car",
"displayName": "Car",
"description": "Car owner",
"createdAt": "2015-02-03T22:36:23Z",
"updatedAt": "2015-02-03T22:36:24Z",
"idField": "marketoGUID",
"dedupeFields": [
"vin"
],
"searchableFields": [
[
"vin"
],
[
"marketoGUID"
],
[
"siebelId"
]
],
"relationships": [
{
"field": "siebelId",
"type": "parent",
"relatedTo": {
"name": "Lead",
"field": "siebelId"
}
}
]
}
]
}
}
Raw Request
Send raw HTTP request to Marketo | key: rawRequest
Sync Companies (Create, Update, Upsert)
Allows inserting, updating, or upserting of company records into Marketo. | key: syncCompanies
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"status": "updated",
"id": 1232
},
{
"seq": 1,
"status": "created",
"id": 1323
}
]
}
}
Sync Custom Objects (Create, Update, Upsert)
Inserts, updates, or upserts custom object records to the target instance. | key: syncCustomObjects
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"status": "updated",
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb"
},
{
"seq": 1,
"status": "created",
"marketoGUID": "cff23271-f996-47d7-984f-f2676861b5fb"
},
{
"seq": 2,
"status": "skipped",
"reasons": [
{
"code": "1004",
"message": "Lead not found"
}
]
}
]
}
}
Sync Leads (Create, Update, Upsert)
Syncs a list of leads to the target instance. | key: syncLeads
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"id": 50,
"status": "created"
},
{
"id": 51,
"status": "created"
},
{
"id": 52,
"status": "created"
}
]
}
}
Sync Named Accounts (Create, Update, Upsert)
Allows inserts, updates, or upserts of Named Accounts to the target instance. | key: syncNamedAccounts
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"status": "updated",
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb"
},
{
"seq": 1,
"status": "created",
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fc"
}
]
}
}
Sync Opportunities (Create, Update, Upsert)
Allows inserts, updates, or upserts of Opportunities to the target instance. | key: syncOpportunities
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"status": "updated",
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb"
},
{
"seq": 1,
"status": "created",
"marketoGUID": "cff23271-f996-47d7-984f-f2676861b5fb"
}
]
}
}
Sync Sales Persons (Create, Update, Upsert)
Allows inserts, updates, or upserts of Sales Persons to the target instance. | key: syncSalesPersons
{
"data": {
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"status": "updated",
"id": 45232
},
{
"seq": 1,
"status": "created",
"id": 45236
}
]
}
}