API Reference for Marketo Engage

Create Email Template

POST /rest/asset/v1/emailTemplates.json

Creates a new email template.

Operation ID
createEmailTemplateUsingPOST
Permissions
Read-Write Assets
Request format
multipart/form-data
Returns
ResponseOfEmailTemplateResponse

Request body

multipart/form-data · required · CreateEmailTemplateRequest · 6 properties

Sent as multipart form fields, one part per property. Upload fields take a file.

name string required

Name of the Email Template. Must be unique under the parent folder.

folder Folder required

JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'

Model Folder

id integer (int32) required

Id of the folder

type string required

Type of folder

Values Folder Program

description string

Description of the email template

content string required

HTML content for template. Multipart file.

Responses

200 OK ResponseOfEmailTemplateResponse
errors array of Error

Model Error

code string required

Error code of the error. See full list of error codes here

message string required

Message describing the cause of the error

requestId string
result array of EmailTemplateResponse

Model EmailTemplateResponse

createdAt string (date-time)

Datetime the asset was created

description string

Description of the asset

folder Folder required

JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'

Model Folder

id integer (int32) required

Id of the folder

type string required

Type of folder

Values Folder Program

id integer (int64)

Id of the asset

name string

Name of the asset

status string required

Status filter for draft or approved versions

updatedAt string (date-time)

Datetime the asset was most recently updated

url string

Url of the asset in the Marketo UI

version integer (int32)

Template version type

Values 1 2

workspace string

Name of the workspace

success boolean
warnings array of string
Generated example
{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ],
  "requestId": "123",
  "result": [
    {
      "createdAt": "2026-01-15T10:30:00Z",
      "description": "string",
      "folder": {
        "id": 123,
        "type": "Folder"
      },
      "id": 123,
      "name": "Example name",
      "status": "string",
      "updatedAt": "2026-01-15T10:30:00Z",
      "url": "https://example.com",
      "version": 1,
      "workspace": "string"
    }
  ],
  "success": true,
  "warnings": [
    "string"
  ]
}

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