{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"**This endpoint allows you to create a new design**.\n\nYou can add a new design by passing data, including a string of HTML email content, to `/designs`. When creating designs from scratch, be aware of the styling constraints inherent to many email clients. For a list of best practices, see our guide to [Cross-Platform Email Design](https://sendgrid.com/docs/ui/sending-email/cross-platform-html-design/).\n\nThe Design Library can also convert your design’s HTML elements into drag and drop modules that are editable in the Designs Library user interface. For more, visit the [Design and Code Editor documentation](https://sendgrid.com/docs/ui/sending-email/editor/#drag--drop-markup).\n\nBecause the `/designs` endpoint makes it easy to add designs, you can create a design with your preferred tooling or migrate designs you already own without relying on the Design Library UI.","properties":{"body":{"$ref":"#/definitions/DesignInput"}},"required":[],"additionalProperties":false,"definitions":{"DesignInput":{"title":"Design Input","type":"object","properties":{"name":{"type":"string","description":"The name of the new design.","default":"Duplicate: "},"editor":{"allOf":[{"$ref":"#/definitions/Editor"},{"type":"string"}]},"html_content":{"type":"string","description":"The HTML content of the Design.","maxLength":1048576},"plain_content":{"type":"string","description":"Plain text content of the Design.","maxLength":1048576,"default":""}},"required":["html_content"],"examples":[{"name":"Ahoy, World!","editor":"design","subject":"Getting Started","html_content":"\n\n \n \n \n \n \n \n \n \n \n \n \n \n
\n
\n \n \n \n \n
\n \n \n \n \n
\n \n \n \n \n
\n \n \n \n \n \n
\n \n \n \n
\n

\n
\n \n \n \n \n \n
Ahoy, World!

{{Sender_Name}}

{{Sender_Address}}, {{Sender_City}}, {{Sender_State}} {{Sender_Zip}}

Unsubscribe - Unsubscribe Preferences

\n \n
\n
\n
\n
\n
\n \n ","plain_content":"Ahoy, World!\n\n{{Sender_Name}}\n\n{{Sender_Address}} , {{Sender_City}} , {{Sender_State}} {{Sender_Zip}}\n\nUnsubscribe ( {{{unsubscribe}}} ) - Unsubscribe Preferences ( {{{unsubscribe_preferences}}} )"}]},"Editor":{"type":"string","enum":["code","design"]}}},"name":"Create Design","id":"sendgrid.mc_designs.createdesign","example":{},"maxRequests":1,"summary":false}}