> ## Documentation Index > Fetch the complete documentation index at: https://docs.mapp.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a draft email from a CMS message > Creates a new draft from the rendered CM2 message. Available since API v19. No request body is required. Each successful call creates a new draft owned by the API user. Copies the name, external ID, subject, email content, image handling and message category. Dynamic RSS placeholders are preserved; the draft is not assigned to a sendout group. ## OpenAPI ````json POST /draftmessage/createFromCms { "openapi": "3.0.4", "info": { "title": "Engage public API", "version": "1" }, "servers": [ { "url": "https://your-engage-domain.com/api/rest" } ], "tags": [ { "name": "Address Attributes" }, { "name": "Async" }, { "name": "Audit Log" }, { "name": "Automation" }, { "name": "Blacklist" }, { "name": "CMS (legacy)" }, { "name": "CMS Blocks" }, { "name": "CMS Frameworks" }, { "name": "CMS Messages" }, { "name": "CMS Templates" }, { "name": "Contact" }, { "name": "Content" }, { "name": "Coupon" }, { "name": "Draft Message" }, { "name": "Ecommerce" }, { "name": "Group" }, { "name": "Group Attributes" }, { "name": "Landing Page" }, { "name": "Member Attributes" }, { "name": "Membership" }, { "name": "Message" }, { "name": "Meta" }, { "name": "Mobile Push" }, { "name": "Prepared Message" }, { "name": "Process" }, { "name": "Profile Attributes" }, { "name": "Related Data" }, { "name": "Segmentation" }, { "name": "System" }, { "name": "System User" }, { "name": "Usage Statistics" }, { "name": "User" }, { "name": "Whiteboard" } ], "paths": { "/draftmessage/createFromCms": { "post": { "tags": [ "Draft Message" ], "summary": "Create a draft email from a CM2 message", "description": "Creates a new draft from the rendered CM2 message. Available since API v19. No request body is required. Each successful call creates a new draft owned by the API user. Copies the name, external ID, subject, email content, image handling and message category. Dynamic RSS placeholders are preserved; the draft is not assigned to a sendout group.", "operationId": "CreateDraftMessageFromCms", "parameters": [ { "name": "cmsMessageId", "in": "query", "description": "The positive numeric ID of the source CM2 message.", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "The created draft message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DraftMessage" } } } }, "400": { "description": "Invalid ID, missing CM2 message, invalid content or category, or insufficient CM2 permissions.", "content": { "application/json": {} } }, "500": { "description": "The CM2 message could not be rendered or retrieved.", "content": { "application/json": {} } } } } } }, "components": { "schemas": { "DraftMessage": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "name": { "type": "string" }, "externalId": { "type": "string" }, "messageCategoryId": { "type": "integer", "format": "int64" }, "message": { "$ref": "#/components/schemas/MessageBase" } } }, "MessageBase": { "type": "object", "properties": { "subject": { "type": "string" }, "emailBodyText": { "type": "string" }, "emailBodyHtml": { "type": "string" }, "smsText": { "type": "string" }, "faxText": { "type": "string" }, "emailHeaders": { "type": "array", "items": { "$ref": "#/components/schemas/Attribute" } }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/Attachment" } }, "attachmentReferences": { "type": "array", "items": { "$ref": "#/components/schemas/AttachmentReference" } }, "encoding": { "type": "string" }, "encodingSMS": { "type": "string" }, "imageHandlingMode": { "type": "string" } } }, "Attribute": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } }, "Attachment": { "type": "object", "properties": { "name": { "type": "string" }, "contentType": { "type": "string" }, "content": { "type": "string" } } }, "AttachmentReference": { "type": "object", "properties": { "contentId": { "type": "string" }, "reference": { "type": "string" } } } } } } ````