Mailchimp Mctemplates API
The mctemplates API from Mailchimp — 4 operation(s) for mctemplates.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mailchimp-mctemplates-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
version: 1.4.1
title: Mailchimp Transactional Mctemplates API
contact:
name: API Support
email: apihelp@mailchimp.com
x-permalink: https://github.com/mailchimp/mailchimp-client-lib-codegen/blob/main/spec/transactional.openapi.json
servers:
- url: https://mandrillapp.com/api/1.3
tags:
- name: mctemplates
paths:
/mctemplates/info:
post:
x-custom-config:
methodNameCamel: mcTemplatesInfo
methodNameSnake: mc_templates_info
summary: Get Mailchimp Template info
description: Get information about a Mailchimp Transactional template in your account.
operationId: postMcTemplatesInfo
tags:
- mctemplates
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
description: Information about the Mailchimp Transactional template
properties:
mc_template_id:
description: Mailchimp template ID
type: integer
example: 12345
mc_template_name:
description: Template name
type: string
example: Welcome Email
labels:
description: Array of labels (always empty for transactional templates)
type: array
items:
type: string
example: []
code:
description: Template HTML (draft version)
type: string
example: <div>Welcome!</div>
subject:
description: Default subject line
type: string
example: Welcome to our service
from_email:
description: Default sending address
type: string
example: support@example.com
from_name:
description: Default from name
type: string
example: Support Team
text:
description: Template text (draft version)
type: string
example: Welcome to our service!
publish_code:
description: Template HTML (published version)
type: string
example: <div>Welcome!</div>
publish_text:
description: Template text (published version)
type: string
example: Welcome to our service!
published_at:
description: Date and time when template was published in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
created_at:
description: Date and time when template was created in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26276'
updated_at:
description: Date and time when template was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26277'
draft_updated_at:
description: Date and time when template draft was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
is_broken_template:
description: Whether template has rendering errors
type: boolean
example: false
application/x-php:
schema:
type: object
description: Information about the Mailchimp Transactional template
properties:
mc_template_id:
description: Mailchimp template ID
type: integer
example: 12345
mc_template_name:
description: Template name
type: string
example: Welcome Email
labels:
description: Array of labels (always empty for transactional templates)
type: array
items:
type: string
example: []
code:
description: Template HTML (draft version)
type: string
example: <div>Welcome!</div>
subject:
description: Default subject line
type: string
example: Welcome to our service
from_email:
description: Default sending address
type: string
example: support@example.com
from_name:
description: Default from name
type: string
example: Support Team
text:
description: Template text (draft version)
type: string
example: Welcome to our service!
publish_code:
description: Template HTML (published version)
type: string
example: <div>Welcome!</div>
publish_text:
description: Template text (published version)
type: string
example: Welcome to our service!
published_at:
description: Date and time when template was published in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
created_at:
description: Date and time when template was created in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26276'
updated_at:
description: Date and time when template was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26277'
draft_updated_at:
description: Date and time when template draft was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
is_broken_template:
description: Whether template has rendering errors
type: boolean
example: false
application/x-yaml; charset=utf-8:
schema:
type: object
description: Information about the Mailchimp Transactional template
properties:
mc_template_id:
description: Mailchimp template ID
type: integer
example: 12345
mc_template_name:
description: Template name
type: string
example: Welcome Email
labels:
description: Array of labels (always empty for transactional templates)
type: array
items:
type: string
example: []
code:
description: Template HTML (draft version)
type: string
example: <div>Welcome!</div>
subject:
description: Default subject line
type: string
example: Welcome to our service
from_email:
description: Default sending address
type: string
example: support@example.com
from_name:
description: Default from name
type: string
example: Support Team
text:
description: Template text (draft version)
type: string
example: Welcome to our service!
publish_code:
description: Template HTML (published version)
type: string
example: <div>Welcome!</div>
publish_text:
description: Template text (published version)
type: string
example: Welcome to our service!
published_at:
description: Date and time when template was published in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
created_at:
description: Date and time when template was created in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26276'
updated_at:
description: Date and time when template was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26277'
draft_updated_at:
description: Date and time when template draft was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
is_broken_template:
description: Whether template has rendering errors
type: boolean
example: false
deprecated: false
requestBody:
content:
application/json:
schema:
type: object
required:
- key
- mc_template_id
properties:
key:
type: string
description: a valid api key
mc_template_id:
type: integer
description: the id of the Mailchimp template
required: true
/mctemplates/list:
post:
x-custom-config:
methodNameCamel: mcTemplatesList
methodNameSnake: mc_templates_list
summary: List Mailchimp Transactional Templates
description: Return a list of all Mailchimp Transactional templates available to this user.
operationId: postMcTemplatesList
tags:
- mctemplates
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
description: Array of Mailchimp Transactional templates
items:
type: object
description: Information about the Mailchimp Transactional template
properties:
mc_template_id:
description: Mailchimp template ID
type: integer
example: 12345
mc_template_name:
description: Template name
type: string
example: Welcome Email
labels:
description: Array of labels (always empty for transactional templates)
type: array
items:
type: string
example: []
code:
description: Template HTML (draft version)
type: string
example: <div>Welcome!</div>
subject:
description: Default subject line
type: string
example: Welcome to our service
from_email:
description: Default sending address
type: string
example: support@example.com
from_name:
description: Default from name
type: string
example: Support Team
text:
description: Template text (draft version)
type: string
example: Welcome to our service!
publish_code:
description: Template HTML (published version)
type: string
example: <div>Welcome!</div>
publish_text:
description: Template text (published version)
type: string
example: Welcome to our service!
published_at:
description: Date and time when template was published in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
created_at:
description: Date and time when template was created in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26276'
updated_at:
description: Date and time when template was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26277'
draft_updated_at:
description: Date and time when template draft was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
is_broken_template:
description: Whether template has rendering errors
type: boolean
example: false
application/x-php:
schema:
type: array
description: Array of Mailchimp Transactional templates
items:
type: object
description: Information about the Mailchimp Transactional template
properties:
mc_template_id:
description: Mailchimp template ID
type: integer
example: 12345
mc_template_name:
description: Template name
type: string
example: Welcome Email
labels:
description: Array of labels (always empty for transactional templates)
type: array
items:
type: string
example: []
code:
description: Template HTML (draft version)
type: string
example: <div>Welcome!</div>
subject:
description: Default subject line
type: string
example: Welcome to our service
from_email:
description: Default sending address
type: string
example: support@example.com
from_name:
description: Default from name
type: string
example: Support Team
text:
description: Template text (draft version)
type: string
example: Welcome to our service!
publish_code:
description: Template HTML (published version)
type: string
example: <div>Welcome!</div>
publish_text:
description: Template text (published version)
type: string
example: Welcome to our service!
published_at:
description: Date and time when template was published in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
created_at:
description: Date and time when template was created in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26276'
updated_at:
description: Date and time when template was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26277'
draft_updated_at:
description: Date and time when template draft was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
is_broken_template:
description: Whether template has rendering errors
type: boolean
example: false
application/x-yaml; charset=utf-8:
schema:
type: array
description: Array of Mailchimp Transactional templates
items:
type: object
description: Information about the Mailchimp Transactional template
properties:
mc_template_id:
description: Mailchimp template ID
type: integer
example: 12345
mc_template_name:
description: Template name
type: string
example: Welcome Email
labels:
description: Array of labels (always empty for transactional templates)
type: array
items:
type: string
example: []
code:
description: Template HTML (draft version)
type: string
example: <div>Welcome!</div>
subject:
description: Default subject line
type: string
example: Welcome to our service
from_email:
description: Default sending address
type: string
example: support@example.com
from_name:
description: Default from name
type: string
example: Support Team
text:
description: Template text (draft version)
type: string
example: Welcome to our service!
publish_code:
description: Template HTML (published version)
type: string
example: <div>Welcome!</div>
publish_text:
description: Template text (published version)
type: string
example: Welcome to our service!
published_at:
description: Date and time when template was published in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
created_at:
description: Date and time when template was created in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26276'
updated_at:
description: Date and time when template was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40.26277'
draft_updated_at:
description: Date and time when template draft was last updated in UTC YYYY-MM-DD HH:MM:SS format
type: string
format: date-time
example: '2025-08-29 18:47:40'
is_broken_template:
description: Whether template has rendering errors
type: boolean
example: false
deprecated: false
requestBody:
content:
application/json:
schema:
type: object
required:
- key
properties:
key:
type: string
description: a valid api key
search_query:
description: Optional search query to filter templates
type:
- string
- 'null'
example: '""'
required: true
/mctemplates/render:
post:
x-custom-config:
methodNameCamel: mcTemplatesRender
methodNameSnake: mc_templates_render
summary: Render Mailchimp Transactional Template
description: Render a Mailchimp Transactional template with optional merge variables.
operationId: postMcTemplatesRender
tags:
- mctemplates
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
description: The rendered HTML template
properties:
html:
description: The rendered HTML content with merge variables applied
type: string
example: <html><body>Welcome John!</body></html>
application/x-php:
schema:
type: object
description: The rendered HTML template
properties:
html:
description: The rendered HTML content with merge variables applied
type: string
example: <html><body>Welcome John!</body></html>
application/x-yaml; charset=utf-8:
schema:
type: object
description: The rendered HTML template
properties:
html:
description: The rendered HTML content with merge variables applied
type: string
example: <html><body>Welcome John!</body></html>
deprecated: false
requestBody:
content:
application/json:
schema:
type: object
required:
- key
- mc_template_id
properties:
key:
type: string
description: a valid api key
mc_template_id:
type: integer
description: the id of the Mailchimp template to render
mc_template_version:
description: 'Template version - "published" or "draft". Note: requesting "published" when the template has not been published will return a 404 error.'
type: string
default: published
enum:
- published
- draft
example: published
merge_vars:
type: array
description: an array of merge variables to inject into the template
items:
type: object
properties:
name:
type: string
description: the merge variable name
content:
type: string
description: the merge variable value
required: true
/mctemplates/time-series:
post:
x-custom-config:
methodNameCamel: mcTemplatesTimeSeries
methodNameSnake: mc_templates_time_series
summary: Get Mailchimp Transactional Template Time Series
description: Return the recent history (hourly stats for the last 30 days) for a Mailchimp Transactional template. Returns an empty array if the template exists but has never been used to send messages.
operationId: postMcTemplatesTimeSeries
tags:
- mctemplates
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
description: Array of hourly stats for the template
items:
type: object
properties:
time:
description: The hour as a UTC date string in YYYY-MM-DD HH:00:00 format
type: string
format: date-time
example: '2013-01-01 15:00:00'
sent:
description: The number of emails sent during the time period
type: integer
example: 42
hard_bounces:
description: The number of emails hard bounced during the time period
type: integer
example: 42
soft_bounces:
description: The number of emails soft bounced during the time period
type: integer
example: 42
rejects:
description: The number of emails rejected during the time period
type: integer
example: 42
complaints:
description: The number of spam complaints received during the time period
type: integer
example: 42
unsubs:
description: The number of unsubscribes during the time period
type: integer
example: 42
opens:
description: The number of emails opened during the time period
type: integer
example: 42
unique_opens:
description: The number of unique opens during the time period
type: integer
example: 42
clicks:
description: The number of URLs clicked during the time period
type: integer
example: 42
unique_clicks:
description: The number of unique clicks during the time period
type: integer
example: 42
application/x-php:
schema:
type: array
description: Array of hourly stats for the template
items:
type: object
properties:
time:
description: The hour as a UTC date string in YYYY-MM-DD HH:00:00 format
type: string
format: date-time
example: '2013-01-01 15:00:00'
sent:
description: The number of emails sent during the time period
type: integer
example: 42
hard_bounces:
description: The number of emails hard bounced during the time period
type: integer
example: 42
soft_bounces:
description: The number of emails soft bounced during the time period
type: integer
example: 42
rejects:
description: The number of emails rejected during the time period
type: integer
example: 42
complaints:
description: The number of spam complaints received during the time period
type: integer
example: 42
unsubs:
description: The number of unsubscribes during the time period
type: integer
example: 42
opens:
description: The number of emails opened during the time period
type: integer
example: 42
unique_opens:
description: The number of unique opens during the time period
type: integer
example: 42
clicks:
description: The number of URLs clicked during the time period
type: integer
example: 42
unique_clicks:
description: The number of unique clicks during the time period
type: integer
example: 42
application/x-yaml; charset=utf-8:
schema:
type: array
description: Array of hourly stats for the template
items:
type: object
properties:
time:
description: The hour as a UTC date string in YYYY-MM-DD HH:00:00 format
type: string
format: date-time
example: '2013-01-01 15:00:00'
sent:
description: The number of emails sent during the time period
type: integer
example: 42
hard_bounces:
description: The number of emails hard bounced during the time period
type: integer
example: 42
soft_bounces:
description: The number of emails soft bounced during the time period
type: integer
example: 42
rejects:
description: The number of emails rejected during the time period
type: integer
example: 42
complaints:
description: The number of spam complaints received during the time period
type: integer
example: 42
unsubs:
description: The number of unsubscribes during the time period
type: integer
example: 42
opens:
description: The number of emails opened during the time period
type: integer
example: 42
unique_opens:
description: The number of unique opens during the time period
type: integer
example: 42
clicks:
description: The number of URLs clicked during the time period
type: integer
example: 4
# --- truncated at 32 KB (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/openapi/mailchimp-mctemplates-api-openapi.yml