---
title: "Transactional vs promotional: how Mailercloud classifies your API and SMTP sends"
description: "Every Email API and SMTP message is classified as promotional or transactional — and messages without a campaign type default to promotional. Learn what the classification controls, how to tag OTPs and receipts so they always deliver, and what to do when a transactional email stops arriving."
url: https://help.mailercloud.com/en/articles/241-transactional-vs-promotional-how-mailercloud-classifies-your-api-and-smtp-sends
collection: "API Platform"
updated: 2026-10-29
language: en
---

# Transactional vs promotional: how Mailercloud classifies your API and SMTP sends

Every Email API and SMTP message is classified as promotional or transactional — and messages without a campaign type default to promotional. Learn what the classification controls, how to tag OTPs and receipts so they always deliver, and what to do when a transactional email stops arriving.

## **Why classification matters**

Every message you send through the **Email API** or the **SMTP relay** is classified as promotional or transactional. The classification decides two things:

-   **Promotional** messages carry a one-click unsubscribe option (required by Gmail and Yahoo for bulk senders). A recipient who uses it is automatically added to your suppression list with the reason **Unsubscribed**, and future promotional sends to them are blocked.
    
-   **Transactional** messages — OTPs, password resets, receipts, order confirmations — carry no unsubscribe option and are never blocked by an unsubscribe. A recipient who opted out of your promotional mail still receives them.
    

## **How to classify a message**

**Email API** — set `campaignType` inside `metadata`:

```javascript
{
    "email": { ... },
    "metadata": { "campaignType": "TRANSACTIONAL" },
    "version": "1.0"
}
```

**SMTP relay** — add one header:

```javascript
mld-track-campaign-type: TRANSACTIONAL
```

Both accept exactly two values: `TRANSACTIONAL` or `PROMOTIONAL`.

## **The default — read this if you send OTPs**

<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>If you don't set a campaign type, the message is classified <code>PROMOTIONAL</code>.</p></td></tr></tbody></table>

That default exists so marketing mail always honors unsubscribes — but it means untagged transactional messages are treated as marketing too:

-   They carry an unsubscribe option they shouldn't have.
    
-   If the recipient ever clicked unsubscribe on any of your promotional mail, your untagged OTP or receipt to them will be blocked.
    

<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: #fff6e6; padding: 6pt 9pt; overflow: hidden; overflow-wrap: break-word;"><p><span data-name="pushpin" data-type="emoji">📌</span><strong> Tip: </strong>Always tag transactional flows explicitly. One field on the API — or one header on SMTP — protects them permanently.</p></td></tr></tbody></table>

## **Troubleshooting: a transactional email stopped arriving for one recipient**

<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: 4pt 8pt; overflow: hidden; overflow-wrap: break-word;"><p><strong>API Platform › Suppressions</strong></p></td></tr></tbody></table>

1.  Search the recipient's address on the Suppressions page.
    
2.  If the reason shows **Unsubscribed**, the recipient one-click unsubscribed from a past promotional send — and the blocked message was sent without `campaignType: TRANSACTIONAL`.
    
3.  Fix the sending flow by adding the campaign type as shown above. If the recipient should receive mail again right away, click **Reactivate** on their entry — Unsubscribed entries are self-service.
    

**Further reading**

-   [How to use the suppression list in Mailercloud?](https://help.mailercloud.com/en/articles/204-how-to-use-the-suppression-list-in-mailercloud.md)
    
-   [Message options for Email API & SMTP sends](https://help.mailercloud.com/en/articles/242-message-options-for-email-api-smtp-sends.md)
    
-   [Email API reference — Send email](https://apidoc.mailercloud.com/api-reference/email/send-email)
    
-   [SMTP relay guide](https://apidoc.mailercloud.com/guides/smtp-relay)
    

## **Need help?**

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

Happy emailing! 🚀
