Marketo Smart Lists API
The Smart Lists API from Marketo — 4 operation(s) for smart lists.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/marketo-smart-lists-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
description: Marketo Engage Rest API
version: '1.0'
title: Marketo Engage Rest Smart Lists API
termsOfService: https://www.adobe.com/legal.html
contact:
name: Adobe Developer Relations
url: https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/home
email: ''
license:
name: API License Agreement
url: https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/api-license
servers:
- url: https://localhost:8080/
tags:
- name: Smart Lists
description: Smart List Controller
paths:
/rest/asset/v1/smartList/{id}.json:
get:
tags:
- Smart Lists
summary: Get Smart List by Id
description: 'Retrieves a Smart List record by its id. Required Permissions: Read-Asset or Read-Write Asset'
operationId: getSmartListByIdUsingGET
parameters:
- name: id
in: path
description: Id of the smart list to retrieve
required: true
schema:
type: integer
format: int64
- name: includeRules
in: query
description: Set true to populate smart list rules. Default false
required: false
schema:
type: boolean
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ResponseOfSmartListResponseWithRules'
/rest/asset/v1/smartList/byName.json:
get:
tags:
- Smart Lists
summary: Get Smart List by Name
description: 'Retrieves a Smart List record by its name. Required Permissions: Read-Asset or Read-Write Asset'
operationId: getSmartListByNameUsingGET
parameters:
- name: name
in: query
description: Name of smart list to retrieve
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ResponseOfSmartListResponse'
/rest/asset/v1/smartList/{id}/delete.json:
post:
tags:
- Smart Lists
summary: Delete Smart List
description: 'Deletes the designated Smart List. Required Permissions: Read-Write Asset'
operationId: deleteSmartListByIdUsingPOST
parameters:
- name: id
in: path
description: Id of the smart list to delete
required: true
schema:
type: integer
format: int64
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ResponseOfIdResponse'
/rest/asset/v1/smartLists.json:
get:
tags:
- Smart Lists
summary: Get Smart Lists
description: 'Retrieves a list of user created Smart List records. Required Permissions: Read-Asset or Read-Write Asset'
operationId: getSmartListsUsingGET
parameters:
- name: folder
in: query
description: JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'
required: false
schema:
type: string
- name: offset
in: query
description: Integer offset for paging
required: false
schema:
type: integer
format: int32
- name: maxReturn
in: query
description: Maximum number of smart lists to return. Max 200, default 20.
required: false
schema:
type: integer
format: int32
- name: earliestUpdatedAt
in: query
description: Exclude smart lists prior to this date. Must be valid ISO-8601 string. See <a href="http://developers.marketo.com/rest-api/lead-database/fields/field-types/">Datetime</a> field type description.
required: false
schema:
type: string
- name: latestUpdatedAt
in: query
description: Exclude smart lists after this date. Must be valid ISO-8601 string. See <a href="http://developers.marketo.com/rest-api/lead-database/fields/field-types/">Datetime</a> field type description.
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ResponseOfSmartListResponse'
/rest/asset/v1/smartList/{id}/clone.json:
post:
tags:
- Smart Lists
summary: Clone Smart List
description: 'Clones the designated Smart List. Required Permissions: Read-Write Asset'
operationId: cloneSmartListUsingPOST
parameters:
- name: id
in: path
description: Id of smart list to clone
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ResponseOfSmartListResponse'
requestBody:
content:
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/CloneSmartListRequest'
description: cloneSmartListRequest
required: true
components:
schemas:
SmartListResponse:
type: object
required:
- id
- name
- description
- createdAt
- updatedAt
- url
- folder
- workspace
properties:
id:
type: integer
format: int64
description: Id of the smart list
name:
type: string
description: Name of the smart list
description:
type: string
description: Description of the smart list
createdAt:
type: string
format: date-time
description: Datetime the smart list was created
updatedAt:
type: string
format: date-time
description: Datetime the smart list was most recently updated
url:
type: string
description: Url of the smart list in the Marketo UI
folder:
description: JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'
$ref: '#/components/schemas/Folder'
workspace:
type: string
description: Name of the workspace
Error:
type: object
required:
- code
- message
properties:
code:
type: string
description: Error code of the error. See full list of error codes <a href="https://developers.marketo.com/rest-api/error-codes/">here</a>
message:
type: string
description: Message describing the cause of the error
ResponseOfSmartListResponse:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/Error'
requestId:
type: string
result:
type: array
items:
$ref: '#/components/schemas/SmartListResponse'
success:
type: boolean
warnings:
type: array
items:
type: string
SmartListConditions:
type: object
required:
- activityAttributeId
- activityAttributeName
- operator
- values
- isPrimary
description: JSON representation of smart list conditions
properties:
activityAttributeId:
type: integer
format: int32
description: Id of the activity attribute
activityAttributeName:
type: string
description: Name of activity attribute
operator:
type: string
description: Value of operator
values:
type: array
description: List of values
items:
type: string
isPrimary:
type: boolean
description: Whether the condition is primary or not (first condition of the smart list)
SmartListResponseWithRules:
type: object
required:
- id
- name
- description
- createdAt
- updatedAt
- url
- folder
- workspace
properties:
id:
type: integer
format: int64
description: Id of the smart list
name:
type: string
description: Name of the smart list
description:
type: string
description: Description of the smart list
createdAt:
type: string
format: date-time
description: Datetime the smart list was created
updatedAt:
type: string
format: date-time
description: Datetime the smart list was most recently updated
url:
type: string
description: Url of the smart list in the Marketo UI
folder:
description: JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'
$ref: '#/components/schemas/Folder'
workspace:
type: string
description: Name of the workspace
rules:
description: Rules contained in the smart list
$ref: '#/components/schemas/SmartListRules'
ResponseOfSmartListResponseWithRules:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/Error'
requestId:
type: string
result:
type: array
items:
$ref: '#/components/schemas/SmartListResponseWithRules'
success:
type: boolean
warnings:
type: array
items:
type: string
IdResponse:
type: object
required:
- id
properties:
id:
type: integer
format: int32
description: Id of the asset
SmartListRules:
type: object
required:
- filterMatchType
- triggers
- filters
description: JSON representation of smart list rules
properties:
filterMatchType:
type: string
description: Smart list filter match type (rule logic)
enum:
- All
- Any
- Advanced
triggers:
type: array
description: List of smart list triggers
items:
type: string
filters:
type: array
description: List of smart list filters
items:
$ref: '#/components/schemas/SmartListFilters'
Folder:
type: object
required:
- id
- type
properties:
id:
type: integer
format: int32
description: Id of the folder
type:
type: string
description: Type of folder
enum:
- Folder
- Program
description: JSON representation of a folder
CloneSmartListRequest:
type: object
required:
- name
- folder
properties:
name:
type: string
description: Name for the cloned smart list
folder:
description: JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'
$ref: '#/components/schemas/Folder'
description:
type: string
description: Description of the cloned smart list
SmartListFilters:
type: object
required:
- id
- name
- ruleTypeId
- ruleType
- operator
- conditions
description: JSON representation of smart list filters
properties:
id:
type: integer
format: int32
description: Id of the filter
name:
type: string
description: Name of filter
ruleTypeId:
type: integer
format: int32
description: Id of the rule type
ruleType:
type: string
description: Name of rule type
operator:
type: string
description: Name of operator
conditions:
type: array
description: List of smart list conditions
items:
$ref: '#/components/schemas/SmartListConditions'
ResponseOfIdResponse:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/Error'
requestId:
type: string
result:
type: array
items:
$ref: '#/components/schemas/IdResponse'
success:
type: boolean
warnings:
type: array
items:
type: string