Skip to navigation
API ReferenceTemplates

List templates

Get a list of an account’s available templates.

Authentication

AuthorizationBearer

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

OR
AuthorizationBearer
Authorization using OAuth

Query parameters

fieldslist of stringsOptional

A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.

exclude_fieldslist of stringsOptional

A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

countintegerOptional<=1000Defaults to 10
The number of records to return. Default value is 10. Maximum value is 1000
offsetintegerOptionalDefaults to 0

Used for pagination, this is the number of records from a collection to skip. Default value is 0.

created_bystringOptional
The Mailchimp account user who created the template.
since_date_createdstringOptional

Restrict the response to templates created after the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.

before_date_createdstringOptional

Restrict the response to templates created before the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.

typestringOptional
Limit results based on template type.
categorystringOptional
Limit results based on category.
folder_idstringOptional
The unique folder id.
sort_fieldenumOptional
Returns user templates sorted by the specified field.
Allowed values:
content_typeenumOptional

Limit results based on how the template's content is put together. Only templates of type user can be filtered by content_type. If you want to retrieve saved templates created with the legacy email editor, then filter content_type to template. If you'd rather pull your saved templates for the new editor, filter to multichannel. For code your own templates, filter to html.

Allowed values:
sort_direnumOptional
Determines the order direction for sorted results.
Allowed values:

Response

This endpoint returns an object.
templateslist of objectsOptional
All of an account's saved or custom templates.
total_itemsintegerOptionalRead-only
The total number of items matching the query regardless of pagination.