Mailchimp Developer Documentation

curl -X POST https://mandrillapp.com/api/1.4/templates/add \
     -H "Content-Type: application/json" \
     -d '{
  "key": "ONzNrsmbtNXoIKyfPmjnig",
  "name": "Example Template",
  "from_email": "sender@example.com",
  "from_name": "Example Name",
  "subject": "Welcome to our service",
  "code": "<div>example code</div>",
  "text": "Example text content",
  "publish": true,
  "labels": [
    "example-label"
  ]
}'

{
  "code": "<p>test</p>",
  "created_at": "2025-08-29 18:47:40.26276",
  "draft_updated_at": "2025-08-29 18:47:40",
  "from_email": "test@mailchimp.com",
  "from_name": "Freddie",
  "is_broken_template": false,
  "labels": [],
  "name": "test-template",
  "publish_code": "<p>test</p>",
  "publish_from_email": "test@mailchimp.com",
  "publish_from_name": "Freddie",
  "publish_name": "test-template",
  "publish_subject": "test",
  "publish_text": "test",
  "published_at": "2025-08-29 18:47:40",
  "slug": "test-template",
  "subject": "test",
  "text": "test",
  "updated_at": "2025-08-29 18:47:40.26277"
}

Creates a new email template with the specified content and settings.

Request

This endpoint expects an object.

keystringRequired

A valid Mandrill API key

namestringRequired

Name for the new template - must be unique

from_emailstring or nullOptionalformat: "email"

Default sending address for emails sent using this template

from_namestring or nullOptional

Default from name to be used

subjectstring or nullOptional

Default subject line to be used

codestring or nullOptional

HTML code for the template with mc:edit attributes for editable elements

textstring or nullOptional

Default text part to be used when sending with this template

publishbooleanOptionalDefaults to true

Set to false to add a draft template without publishing

labelslist of stringsOptional

Optional array of up to 10 labels to use for filtering templates

Response

Success

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error