API Reference for Marketo Engage

List Emails

GET /rest/asset/v2/email/filter

Filters and lists email assets by the given criteria.

Note: The totalItems value in the response includes A/B test variants in its count; however, the A/B test variant emails themselves are not returned in the result.

Operation ID
filterContentUsingGET_email
Permissions
Read-Only Assets, Access Design Studio, Access Email
Request format
application/json
Returns
EmailFilterResponse, ErrorResponse

Parameters

18 of 21 have no description in Adobe's specification.

Query 20

access_token string required

Token for Authorization

The Request Builder sends the token in the Authorization header instead, so it never appears in URLs.

workspaceId string required
folderId string
folderType string

Values Folder Program

status array of string
pageIndex integer (int32)
pageSize integer (int32)

Maximum value is 50.

createdAtEnd string
createdAtStart string
modifiedAtStart string
modifiedAtEnd string
name string
sortKey string
sortOrder string

Values ASC DESC

isCreatedByMe boolean
isModifiedByMe boolean
templateId string
scriptEngine string
isValueNonNullable string
includeArchived boolean

Header 1

x-app-type string required

Application type header

Values marketo

Responses

200 OK EmailFilterResponse
success boolean
requestId string
result EmailFilterResult

Model EmailFilterResult

totalItems integer (int32)
pageSize integer (int32)
currentPage integer (int32)
items array of EmailContentDTO

Model EmailContentDTO

id string
name string
description string
appType string
headers EmailHeadersDTO

Model EmailHeadersDTO

result › items › headers

ccEmails array of string
fromEmail string
fromName string
preheader string
replyEmail string
subject string required
metadata ContentMetadataDTO

Model ContentMetadataDTO

result › items › metadata

createdBy string
createdAt string
createdById string
createdByAepId string
modifiedBy string
modifiedAt string
modifiedById string
modifiedByAepId string
settings EmailSettingsResponseDTO

Model EmailSettingsResponseDTO

result › items › settings

isOperational boolean
isWebPageView boolean
isTextOnly boolean
disableOpenTracking boolean
enableUrlTracking boolean
status string
state string
virtualId string
associatedStates array of AssociatedStateDTO

Model AssociatedStateDTO

result › items › associatedStates

contentId string
externalId string
state string
appData EmailAppDataResponseDTO

Model EmailAppDataResponseDTO

result › items › appData

editorType string
workspaceId string
folderId string
programId string
programName string
programType string
templateId string
externalId string
editorContext EditorContextDto

Model EditorContextDto

result › items › editorContext

dynamicContent object
scriptEngine string
Generated example
{
  "success": true,
  "requestId": "123",
  "result": {
    "totalItems": 123,
    "pageSize": 123,
    "currentPage": 123,
    "items": [
      {
        "id": "123",
        "name": "Example name",
        "description": "string",
        "appType": "string",
        "headers": {
          "ccEmails": [
            null
          ],
          "fromEmail": "person@example.com",
          "fromName": "Example name",
          "preheader": "string",
          "replyEmail": "person@example.com",
          "subject": "string"
        },
        "metadata": {
          "createdBy": "string",
          "createdAt": "string",
          "createdById": "123",
          "createdByAepId": "123",
          "modifiedBy": "string",
          "modifiedAt": "string",
          "modifiedById": "123",
          "modifiedByAepId": "123"
        },
        "settings": {
          "isOperational": true,
          "isWebPageView": true,
          "isTextOnly": true,
          "disableOpenTracking": true,
          "enableUrlTracking": true
        },
        "status": "string",
        "state": "string",
        "virtualId": "123",
        "associatedStates": [
          {
            "contentId": null,
            "externalId": null,
            "state": null
          }
        ],
        "appData": {
          "editorType": "string",
          "workspaceId": "123",
          "folderId": "123",
          "programId": "123",
          "programName": "Example name",
          "programType": "string"
        },
        "templateId": "123",
        "externalId": "123",
        "editorContext": {
          "dynamicContent": {}
        },
        "scriptEngine": "string"
      }
    ]
  }
}
Default Error ErrorResponse
success boolean
requestId string
errors array of ContentWaveErrorDTO

Model ContentWaveErrorDTO

key string
message string
code string
dynamicMessage string
type string

Severity of the entry: info, warning, or error.

source string

Origin of the entry, e.g. validation, template, fragment, message_render, asset_publish.

errorMessage string
errorPosition object

Location in the content the entry refers to (for script/validation errors).

Generated example
{
  "success": true,
  "requestId": "123",
  "errors": [
    {
      "key": "string",
      "message": "string",
      "code": "string",
      "dynamicMessage": "string",
      "type": "string",
      "source": "string",
      "errorMessage": "string",
      "errorPosition": {
        "line": 123,
        "column": 123
      }
    }
  ]
}

Referenced models

Generated from swagger-asset.json. Generated examples are inferred from the schema; they are illustrative and may not be valid production payloads.

↑ ↓ to move, ↵ to open, esc to closeSee all results