---
title: "Message options for Email API & SMTP sends"
description: "Every per-message option in one place — campaign type, open and inbox tracking, tags, campaign ID, content storage, auto-text, custom webhook data and your own List-Unsubscribe header — with the matching Email API field and SMTP header for each."
url: https://help.mailercloud.com/en/articles/242-message-options-for-email-api-and-smtp-sends
collection: "API Platform"
updated: 2026-10-29
language: en
---

# Message options for Email API & SMTP sends

Every per-message option in one place — campaign type, open and inbox tracking, tags, campaign ID, content storage, auto-text, custom webhook data and your own List-Unsubscribe header — with the matching Email API field and SMTP header for each.

Every option below can be set per message. On the **Email API** they are JSON fields in the request; on the **SMTP relay** they are headers prefixed `mld-track-`, which Mailercloud consumes — recipients never see them.

## **The per-message options**

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1" style="vertical-align: top; background-color: #f3f4f6; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><strong>Option</strong></p></td><td colspan="1" rowspan="1" style="vertical-align: top; background-color: #f3f4f6; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><strong>Email API field</strong></p></td><td colspan="1" rowspan="1" style="vertical-align: top; background-color: #f3f4f6; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><strong>SMTP header</strong></p></td></tr><tr><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p>Campaign type</p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>metadata.campaignType</code></p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>mld-track-campaign-type</code></p></td></tr><tr><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p>Open tracking</p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p>automatic with a tracking domain</p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>mld-track-opens</code></p></td></tr><tr><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p>Tags</p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>tags</code></p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>mld-track-tag</code></p></td></tr><tr><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p>Campaign ID</p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>campaign_id</code></p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>mld-track-campaign-id</code></p></td></tr><tr><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p>Inbox tracking</p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>inbox_tracking</code></p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>mld-track-inbox</code></p></td></tr><tr><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p>Content storage</p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>store_content</code></p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>mld-track-store-content</code></p></td></tr><tr><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p>Auto text</p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>auto_text</code></p></td><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><code>mld-track-auto-text</code></p></td></tr></tbody></table>

### **What each option does**

-   **Campaign type** — `TRANSACTIONAL` or `PROMOTIONAL`; the default is `PROMOTIONAL` when omitted. This option controls unsubscribe behavior — see the classification article under Further reading.
    
-   **Open tracking** — automatic on the Email API whenever your sending domain has a tracking domain; on SMTP, `true`/`false` overrides the domain-level Open Tracking setting for one message.
    
-   **Tags** — labels for filtering the Activity list; up to 10 tags of 100 characters each. Comma-separated in the SMTP header.
    
-   **Campaign ID** — groups sends for reporting and inbox tracking; letters, numbers and hyphens, up to 100 characters.
    
-   **Inbox tracking** — set `true` to track inbox placement with the Inbox Tracker add-on; a campaign ID is then required.
    
-   **Content storage** — set `false` to skip storing the message content, recommended for sensitive bodies such as OTP emails.
    
-   **Auto text** — set `false` to send an HTML-only message as HTML only, without a generated plain-text part.
    

## **Custom data returned on webhooks**

Attach your own reference data and get it back unchanged on every webhook event for the message: extra keys inside `metadata.custom` on the Email API, or one header per key prefixed `X-MC-Custom-` on SMTP (for example `X-MC-Custom-order-id: 12345`).

Limits: up to 10 keys; key names up to 50 characters using `A–Z a–z 0–9 - _`; values up to 256 characters, returned as strings. Keys that break the rules are dropped and listed in the webhook's `custom_dropped` array — see Webhooks in API Platform for the payloads.

<table style="min-width: 25px;"><colgroup><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1" style="vertical-align: top; background-color: #eef4ff; padding: 6pt 9pt; overflow: hidden; overflow-wrap: break-word;"><p><span data-name="memo" data-type="emoji">📝</span><strong> Note: </strong>The <code>mld-track-*</code> and <code>X-MC-Custom-*</code> headers are consumed by Mailercloud and stripped before delivery — the recipient never sees them.</p></td></tr></tbody></table>

## **Your own List-Unsubscribe header**

You may supply your own `List-Unsubscribe` header; your value replaces the one Mailercloud adds to promotional messages. Rules:

-   Comma-separated values in angle brackets, each starting with `https://` or `mailto:` — plain `http://` is rejected.
    
-   `List-Unsubscribe-Post`, if supplied, must be exactly `List-Unsubscribe=One-Click` and requires `List-Unsubscribe` in the same message.
    

## **Headers Mailercloud manages**

Headers the platform owns — `From`, `Message-ID`, `Date`, `DKIM-Signature`, `Feedback-ID`, authentication headers and the `Content-*` family, among others — are always set by Mailercloud. On the Email API, supplying a reserved header returns an error; on SMTP it is removed and replaced with the platform's own.

**Further reading**

-   [Transactional vs promotional: how Mailercloud classifies your API and SMTP sends](https://help.mailercloud.com/en/articles/241-transactional-vs-promotional-how-mailercloud-classifies-your-api-and-smtp-sends.md)
    
-   [How to use the suppression list in Mailercloud?](https://help.mailercloud.com/en/articles/204-how-to-use-the-suppression-list-in-mailercloud.md)
    
-   [Webhooks in API Platform](https://help.mailercloud.com/en/articles/221-webhooks-in-api-platform.md)
    
-   [SMTP relay guide](https://apidoc.mailercloud.com/guides/smtp-relay)
    

## **Need help?**

If you have any questions about message options, contact us at **support@mailercloud.com** — the Mailercloud support team is ready to help.

Happy emailing! 🚀
