> ## 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 prepared email from a CMS message > Available since API v19. Creates a new prepared email without sending it. No request body is required. An explicit groupId overrides the CM2 message's group. If neither provides a valid group, the request fails. The selected group must belong to the current customer. Uses the customer's first active email channel, as with draft-to-prepared conversion. Returns the persisted, unpersonalized PreparedMessage. ## OpenAPI ````json POST /preparedmessage/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": { "/preparedmessage/createFromCms": { "post": { "tags": [ "Prepared Message" ], "summary": "Create a prepared email from a CM2 message", "description": "Available since API v19. Creates a new prepared email without sending it. No request body is required. An explicit groupId overrides the CM2 message's group. If neither provides a valid group, the request fails. The selected group must belong to the current customer. Uses the customer's first active email channel, as with draft-to-prepared conversion. Returns the persisted, unpersonalized PreparedMessage.", "operationId": "CreatePreparedMessageFromCms", "parameters": [ { "name": "cmsMessageId", "in": "query", "description": "The required positive ID of the source CM2 message.", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "groupId", "in": "query", "description": "Optional positive group ID. Overrides the CM2 group assignment when provided.", "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "The created prepared message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PreparedMessage" } } } }, "400": { "description": "Invalid or missing CM2 message, group, content or category; insufficient permissions; or no active email channel.", "content": { "application/json": {} } }, "500": { "description": "An unexpected composition or persistence error occurred.", "content": { "application/json": {} } } } } } }, "components": { "schemas": { "PreparedMessage": { "type": "object", "properties": { "contactId": { "type": "integer", "format": "int64" }, "messageId": { "type": "integer", "format": "int64" }, "name": { "type": "string" }, "groupId": { "type": "integer", "format": "int64" }, "groupName": { "type": "string" }, "selectionId": { "type": "integer", "format": "int64" }, "selectionName": { "type": "string" }, "channelId": { "type": "integer", "format": "int64" }, "channelName": { "type": "string" }, "externalId": { "type": "string" }, "messageCategoryId": { "type": "integer", "format": "int64" }, "messageCategoryName": { "type": "string" }, "message": { "$ref": "#/components/schemas/MessageBase" }, "trackingOverride": { "type": "integer", "format": "int64" } } }, "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" } } } } } } ````