![marketo icon](/docs/img/components/icons/60/bWFya2V0bw==.png) # Adobe Marketo Engage Connector key: marketo[Source](https://github.com/prismatic-io/components/tree/main/components/marketo)[API Docs](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/home)[API Changelog](https://experienceleague.adobe.com/en/docs/marketo/using/release-notes/current)[Connector Changelog](#changelog) ## Description[​](#description "Direct link to Description") [Adobe Marketo Engage](https://www.marketo.com/) is a marketing automation platform. This component allows you to manage leads, companies, and custom objects in Adobe Marketo Engage. #### API Documentation[​](#api-documentation "Direct link to API Documentation") This component was built using the [Marketo REST API](https://developers.marketo.com/rest-api/). 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](https://developers.marketo.com/rest-api/marketo-integration-best-practices/) for more information on rate limits. ## Connections[​](#connections "Direct link to Connections") ### OAuth 2.0[​](#oauth2 "Direct link to OAuth 2.0") **key: oauth2** 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](https://developers.marketo.com/rest-api/authentication/). 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. | Input | Notes | Example | | ------------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------- | | Client ID | Client Identifier of your app for the Marketo API | | | Client Secret | Client Secret of your app for the Marketo API | | | Scopes | Scopes for the Marketo API. The value is supplied by the API based on the authenticated client. | | | Token URL | The OAuth 2.0 Token URL for the Marketo API. Replace \ with your Account Id. | https\://\.mktorest.com/identity/oauth/token | ## Data Sources[​](#data-sources "Direct link to Data Sources") ### Select Company[​](#selectcompany "Direct link to Select Company") Select a Company from a dropdown menu. | **key: selectCompany** | **type: picklist** | Input | Notes | Example | | ------------- | ----------------------------------------------------- | ---------------------- | | Connection | | | | Filter Query | Filter results by matching this text. | Some text to filter by | | Filter Type | The field to filter on | | | Filter Values | A list of values to filter on for the specified field | | *** ### Select Custom Object[​](#selectcustomobject "Direct link to Select Custom Object") Select a custom object type from a dropdown menu. | **key: selectCustomObject** | **type: picklist** | Input | Notes | Example | | ------------ | ------------------------------------- | ---------------------- | | Connection | | | | Filter Query | Filter results by matching this text. | Some text to filter by | Example Payload for Select Custom Object[⤓](https://prismatic.io/docs/example-payloads/marketo/data-sources/selectCustomObject.json "Download example payload") Loading… *** ### Select Lead[​](#selectlead "Direct link to Select Lead") Select a Lead field from a dropdown menu. | **key: selectLead** | **type: picklist** | Input | Notes | Example | | ------------ | ------------------------------------- | ---------------------- | | Connection | | | | Filter Query | Filter results by matching this text. | Some text to filter by | *** ## Actions[​](#actions "Direct link to Actions") ### Delete Companies[​](#deletecompanies "Direct link to Delete Companies") Delete one or more Companies. | **key: deleteCompanies** | Input | Notes | Example | | ---------- | ----------------------------------------------------------------------------- | ------------ | | Connection | | | | Delete By | The type of deletion method | dedupeFields | | Ids | An array of objects that specify the id->value mapping for objects to delete. | | Example Payload for Delete Companies[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/deleteCompanies.json "Download example payload") Loading… *** ### Delete Custom Objects[​](#deletecustomobjects "Direct link to Delete Custom Objects") Delete one or more Custom Objects. | **key: deleteCustomObjects** | Input | Notes | Example | | ------------------ | ----------------------------------------------------------------------------- | ------------ | | Connection | | | | Custom Object Name | The name of the Custom Object | | | Delete By | The type of deletion method | dedupeFields | | Ids | An array of objects that specify the id->value mapping for objects to delete. | | Example Payload for Delete Custom Objects[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/deleteCustomObjects.json "Download example payload") Loading… *** ### Delete Leads[​](#deleteleads "Direct link to Delete Leads") Delete one or more Leads by their Marketo id. | **key: deleteLeads** | Input | Notes | Example | | ---------- | --------------------------------------------- | ------- | | Connection | | | | Ids | The Marketo id(s) of the record(s) to delete. | | Example Payload for Delete Leads[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/deleteLeads.json "Download example payload") Loading… *** ### Delete Named Accounts[​](#deletenamedaccounts "Direct link to Delete Named Accounts") Delete one or more Named Accounts. | **key: deleteNamedAccounts** | Input | Notes | Example | | ---------- | ----------------------------------------------------------------------------- | ------------ | | Connection | | | | Delete By | The type of deletion method | dedupeFields | | Ids | An array of objects that specify the id->value mapping for objects to delete. | | Example Payload for Delete Named Accounts[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/deleteNamedAccounts.json "Download example payload") Loading… *** ### Delete Opportunities[​](#deleteopportunities "Direct link to Delete Opportunities") Delete one or more Opportunities. | **key: deleteOpportunities** | Input | Notes | Example | | ---------- | ----------------------------------------------------------------------------- | ------------ | | Connection | | | | Delete By | The type of deletion method | dedupeFields | | Ids | An array of objects that specify the id->value mapping for objects to delete. | | Example Payload for Delete Opportunities[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/deleteOpportunities.json "Download example payload") Loading… *** ### Delete Sales Persons[​](#deletesalespersons "Direct link to Delete Sales Persons") Delete one or more Sales Persons. | **key: deleteSalesPersons** | Input | Notes | Example | | ---------- | ----------------------------------------------------------------------------- | ------------ | | Connection | | | | Delete By | The type of deletion method | dedupeFields | | Ids | An array of objects that specify the id->value mapping for objects to delete. | | Example Payload for Delete Sales Persons[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/deleteSalesPersons.json "Download example payload") Loading… *** ### Describe Company[​](#describecompany "Direct link to Describe Company") Returns metadata about companies and the fields available for interaction via the API. | **key: describeCompany** | Input | Notes | Example | | ---------- | ----- | ------- | | Connection | | | Example Payload for Describe Company[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/describeCompany.json "Download example payload") Loading… *** ### Describe Custom Object[​](#describecustomobject "Direct link to Describe Custom Object") Returns metadata regarding a given custom object. | **key: describeCustomObject** | Input | Notes | Example | | ------------------ | ----------------------------- | ------- | | Connection | | | | Custom Object Name | The name of the Custom Object | | Example Payload for Describe Custom Object[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/describeCustomObject.json "Download example payload") Loading… *** ### Describe Lead[​](#describelead "Direct link to 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** | Input | Notes | Example | | ---------- | ----- | ------- | | Connection | | | Example Payload for Describe Lead[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/describeLead.json "Download example payload") Loading… *** ### Describe Named Account[​](#describenamedaccount "Direct link to Describe Named Account") Returns metadata about Named Accounts and the fields available for interaction via the API. | **key: describeNamedAccount** | Input | Notes | Example | | ---------- | ----- | ------- | | Connection | | | Example Payload for Describe Named Account[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/describeNamedAccount.json "Download example payload") Loading… *** ### Describe Opportunities[​](#describeopportunities "Direct link to Describe Opportunities") Returns metadata about Opportunities and the fields available for interaction via the API. | **key: describeOpportunities** | Input | Notes | Example | | ---------- | ----- | ------- | | Connection | | | Example Payload for Describe Opportunities[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/describeOpportunities.json "Download example payload") Loading… *** ### Describe Sales Person[​](#describesalesperson "Direct link to Describe Sales Person") Returns metadata about Sales Persons and the fields available for interaction via the API. | **key: describeSalesPerson** | Input | Notes | Example | | ---------- | ----- | ------- | | Connection | | | Example Payload for Describe Sales Person[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/describeSalesPerson.json "Download example payload") Loading… *** ### Get Companies By Filter[​](#getcompaniesbyfilter "Direct link to Get Companies By Filter") Retrieves company records from the destination instance based on the submitted filter. | **key: getCompaniesByFilter** | Input | Notes | Example | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | Batch Size | The batch size to return | | | Connection | | | | Fetch All | Whether to fetch all records or just the first page. | false | | Fields | List of field names to include | | | Filter Type | The field to filter on | | | Filter Values | A list of values to filter on for the specified field | | | Next Page Token | A token will be returned by this endpoint if the result set is greater than the batch size and can be passed in a subsequent call through this parameter | | Example Payload for Get Companies By Filter[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/getCompaniesByFilter.json "Download example payload") Loading… *** ### Get Custom Objects By Filter[​](#getcustomobjectsbyfilter "Direct link to Get Custom Objects By Filter") Retrieves a list of custom objects records based on filter and set of values. | **key: getCustomObjectsByFilter** | Input | Notes | Example | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | Batch Size | The batch size to return | | | Connection | | | | Custom Object Name | The name of the Custom Object | | | Fields | List of field names to include | | | Filter Type | The field to filter on | | | Filter Values | A list of values to filter on for the specified field | | | Next Page Token | A token will be returned by this endpoint if the result set is greater than the batch size and can be passed in a subsequent call through this parameter | | Example Payload for Get Custom Objects By Filter[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/getCustomObjectsByFilter.json "Download example payload") Loading… *** ### Get Lead By Id[​](#getleadbyid "Direct link to Get Lead By Id") Retrieves a single lead record through its Marketo id. | **key: getLeadById** | Input | Notes | Example | | ---------- | ------------------------------ | ------- | | Connection | | | | Fields | List of field names to include | | | Lead Id | The Marketo lead id. | | Example Payload for Get Lead By Id[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/getLeadById.json "Download example payload") Loading… *** ### Get Leads By Filter[​](#getleadsbyfilter "Direct link to Get Leads By Filter") Returns a list of up to 300 leads based on a list of values in a particular field. | **key: getLeadsByFilter** | Input | Notes | Example | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | Batch Size | The batch size to return | | | Connection | | | | Fields | List of field names to include | | | Filter Type | The field to filter on | | | Filter Values | A list of values to filter on for the specified field | | | Next Page Token | A token will be returned by this endpoint if the result set is greater than the batch size and can be passed in a subsequent call through this parameter | | Example Payload for Get Leads By Filter[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/getLeadsByFilter.json "Download example payload") Loading… *** ### Get Named Accounts By Filter[​](#getnamedaccountsbyfilter "Direct link to Get Named Accounts By Filter") Retrieves Named Account records from the destination instance based on the submitted filter. | **key: getNamedAccountsByFilter** | Input | Notes | Example | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | Batch Size | The batch size to return | | | Connection | | | | Fields | List of field names to include | | | Filter Type | The field to filter on | | | Filter Values | A list of values to filter on for the specified field | | | Next Page Token | A token will be returned by this endpoint if the result set is greater than the batch size and can be passed in a subsequent call through this parameter | | Example Payload for Get Named Accounts By Filter[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/getNamedAccountsByFilter.json "Download example payload") Loading… *** ### Get Opportunities By Filter[​](#getopportunitiesbyfilter "Direct link to Get Opportunities By Filter") Retrieves Opportunity records from the destination instance based on the submitted filter. | **key: getOpportunitiesByFilter** | Input | Notes | Example | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | Batch Size | The batch size to return | | | Connection | | | | Fields | List of field names to include | | | Filter Type | The field to filter on | | | Filter Values | A list of values to filter on for the specified field | | | Next Page Token | A token will be returned by this endpoint if the result set is greater than the batch size and can be passed in a subsequent call through this parameter | | Example Payload for Get Opportunities By Filter[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/getOpportunitiesByFilter.json "Download example payload") Loading… *** ### Get Sales Persons By Filter[​](#getsalespersonsbyfilter "Direct link to Get Sales Persons By Filter") Retrieves Sales Person records from the destination instance based on the submitted filter. | **key: getSalesPersonsByFilter** | Input | Notes | Example | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | Batch Size | The batch size to return | | | Connection | | | | Fields | List of field names to include | | | Filter Type | The field to filter on | | | Filter Values | A list of values to filter on for the specified field | | | Next Page Token | A token will be returned by this endpoint if the result set is greater than the batch size and can be passed in a subsequent call through this parameter | | Example Payload for Get Sales Persons By Filter[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/getSalesPersonsByFilter.json "Download example payload") Loading… *** ### Get Searchable Lead Fields[​](#getsearchableleadfields "Direct link to Get Searchable Lead Fields") Returns list of searchable fields on lead objects in the target instance. | **key: getSearchableLeadFields** | Input | Notes | Example | | ---------- | ----- | ------- | | Connection | | | Example Payload for Get Searchable Lead Fields[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/getSearchableLeadFields.json "Download example payload") Loading… *** ### List Custom Objects[​](#listcustomobjects "Direct link to 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** | Input | Notes | Example | | ---------- | ----- | ------- | | Connection | | | Example Payload for List Custom Objects[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/listCustomObjects.json "Download example payload") Loading… *** ### Raw Request[​](#rawrequest "Direct link to Raw Request") Send raw HTTP request to Marketo | **key: rawRequest** | Input | Notes | Example | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | | Connection | | | | Data | The HTTP body payload to send to the URL. | {"exampleKey": "Example Data"} | | File Data | File Data to be sent as a multipart form upload. | \[{key: "example.txt", value: "My File Contents"}] | | File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. | | | Form Data | The Form Data to be sent as a multipart form upload. | \[{"key": "Example Key", "value": new Buffer("Hello World")}] | | Header | A list of headers to send with the request. | User-Agent: curl/7.64.1 | | Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 | | Method | The HTTP method to use. | | | Query Parameter | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1\&key2=value2. | | | Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json | | Retry On All Errors | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. | false | | Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 | | Timeout | The maximum time that a client will await a response to its request | 2000 | | URL | This is the URL to call. | /v1/leads.json | | Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. | false | *** ### Sync Companies (Create, Update, Upsert)[​](#synccompanies "Direct link to Sync Companies (Create, Update, Upsert)") Allows inserting, updating, or upserting of company records into Marketo. | **key: syncCompanies** | Input | Notes | Example | | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------- | | Action | Type of sync operation to perform | createOrUpdate | | Companies | An array of Company objects to use as input for synchronization. | | | Connection | | | | Dedupe Field | Field to deduplicate on. If the value in the field for a given record is not unique, an error will be returned for the individual record. | dedupeFields | Example Payload for Sync Companies (Create, Update, Upsert)[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/syncCompanies.json "Download example payload") Loading… *** ### Sync Custom Objects (Create, Update, Upsert)[​](#synccustomobjects "Direct link to Sync Custom Objects (Create, Update, Upsert)") Inserts, updates, or upserts custom object records to the target instance. | **key: syncCustomObjects** | Input | Notes | Example | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------- | | Action | Type of sync operation to perform | createOrUpdate | | Connection | | | | Custom Object Name | The name of the Custom Object | | | Custom Objects | An array of Custom Objects to use as input for synchronization. | | | Dedupe Field | Field to deduplicate on. If the value in the field for a given record is not unique, an error will be returned for the individual record. | dedupeFields | Example Payload for Sync Custom Objects (Create, Update, Upsert)[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/syncCustomObjects.json "Download example payload") Loading… *** ### Sync Leads (Create, Update, Upsert)[​](#syncleads "Direct link to Sync Leads (Create, Update, Upsert)") Syncs a list of leads to the target instance. | **key: syncLeads** | Input | Notes | Example | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | | Action | Type of sync operation to perform | createOrUpdate | | Async Processing | If set to true, the call will return immediately | false | | Connection | | | | Leads | An array of Lead objects to use as input for synchronization. | | | Lookup Field | Field to deduplicate on. The field must be present in each lead record of the input. Defaults to email if unset. | email | | Partition Name | Name of the partition to operate on, if applicable. Should be set whenever possible, when interacting with an instance where partitions are enabled. | | Example Payload for Sync Leads (Create, Update, Upsert)[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/syncLeads.json "Download example payload") Loading… *** ### Sync Named Accounts (Create, Update, Upsert)[​](#syncnamedaccounts "Direct link to Sync Named Accounts (Create, Update, Upsert)") Allows inserts, updates, or upserts of Named Accounts to the target instance. | **key: syncNamedAccounts** | Input | Notes | Example | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------- | | Action | Type of sync operation to perform | createOrUpdate | | Connection | | | | Dedupe Field | Field to deduplicate on. If the value in the field for a given record is not unique, an error will be returned for the individual record. | dedupeFields | | Named Accounts | An array of Named Account objects to use as input for synchronization. | | Example Payload for Sync Named Accounts (Create, Update, Upsert)[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/syncNamedAccounts.json "Download example payload") Loading… *** ### Sync Opportunities (Create, Update, Upsert)[​](#syncopportunities "Direct link to Sync Opportunities (Create, Update, Upsert)") Allows inserts, updates, or upserts of Opportunities to the target instance. | **key: syncOpportunities** | Input | Notes | Example | | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------- | | Action | Type of sync operation to perform | createOrUpdate | | Connection | | | | Dedupe Field | Field to deduplicate on. If the value in the field for a given record is not unique, an error will be returned for the individual record. | dedupeFields | | Opportunities | An array of Opportunities objects to use as input for synchronization. | | Example Payload for Sync Opportunities (Create, Update, Upsert)[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/syncOpportunities.json "Download example payload") Loading… *** ### Sync Sales Persons (Create, Update, Upsert)[​](#syncsalespersons "Direct link to Sync Sales Persons (Create, Update, Upsert)") Allows inserts, updates, or upserts of Sales Persons to the target instance. | **key: syncSalesPersons** | Input | Notes | Example | | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------- | | Action | Type of sync operation to perform | createOrUpdate | | Connection | | | | Dedupe Field | Field to deduplicate on. If the value in the field for a given record is not unique, an error will be returned for the individual record. | dedupeFields | | Sales Persons | An array of Sales Person objects to use as input for synchronization. | | Example Payload for Sync Sales Persons (Create, Update, Upsert)[⤓](https://prismatic.io/docs/example-payloads/marketo/actions/syncSalesPersons.json "Download example payload") Loading… *** ## Changelog[​](#changelog "Direct link to Changelog") ### 2026-04-30[​](#2026-04-30 "Direct link to 2026-04-30") Updated spectral version ### 2026-03-31[​](#2026-03-31 "Direct link to 2026-03-31") Various modernizations and documentation updates ### 2026-03-05[​](#2026-03-05 "Direct link to 2026-03-05") Added inline data source for custom objects to enable dynamic dropdown selection ### 2025-10-21[​](#2025-10-21 "Direct link to 2025-10-21") Added inline data sources for companies and leads to enhance data selection capabilities