Skip to navigation
API ReferenceTemplates

Add template

Create a new template for the account. Only Classic templates are supported.

Authentication

AuthorizationBearer

Authorization using a Mailchimp API key (a.k.a. Bearer token)

OR
AuthorizationBearer
Authorization using OAuth

Request

Information about a specific template.
htmlstringRequired

The raw HTML for the template. We support the Mailchimp Template Language in any HTML code passed via the API.

namestringRequired
The name of the template.
folder_idstringOptional
The id of the folder the template is currently in.

Response

This endpoint returns an object.
activebooleanOptionalRead-only
User templates are not 'deleted,' but rather marked as 'inactive.' Returns whether the template is still active.
categorystringOptionalRead-only
If available, the category the template is listed in.
content_typeenumOptionalRead-only
How the template's content is put together.
Allowed values:
created_bystringOptionalRead-only
The login name for template's creator.
date_createddatetimeOptionalRead-only
The date and time the template was created in ISO 8601 format.
date_editeddatetimeOptionalRead-only
The date and time the template was edited in ISO 8601 format.
drag_and_dropbooleanOptionalRead-only
Whether the template uses the drag and drop editor.
edited_bystringOptionalRead-only
The login name who last edited the template.
folder_idstringOptional
The id of the folder the template is currently in.
idintegerOptionalRead-only
The individual id for the template.
namestringOptional
The name of the template.
responsivebooleanOptionalRead-only
Whether the template contains media queries to make it responsive.
share_urlstringOptionalRead-only

The URL used for template sharing.

thumbnailstringOptionalRead-only
If available, the URL for a thumbnail of the template.
typestringOptionalRead-only

The type of template (user, base, or gallery).