1. Mailjet
  2. Support
  3. Documentation

Emails Headers (X-headers)

Custom Headers


X-Mailjet-Campaign

This header value must be unique for all emails belonging to a specific campaign. This will regroup emails into only one line in your dashboard, and provide cool reports !
It can be an alpha-numeric value of your choice (space, dash and underscore are also accepted), up to 255 characters long on one line.

X-Mailjet-DeduplicateCampaign

In combination with X-Mailjet-Campaign, this boolean (true, yes, y, 1) indicates that you do not wish to send a message inside the campaign twice to the same recipient. In this case, we check that the recipient hasn’t been sent the message, or otherwise block any duplicate (only the first message goes through).
Please note that this is based on recipient email address, it will not block a message sent to the same person on two different email addresses.

X-MJ-CustomID

This custom value will help you track your message more easily.

X-MJ-EventPayload

If you need more than an ID, no problem: insert a payload to your messages, using any format (XML, JSON, CSV…)

X-Mailjet-TrackOpen

This boolean (0 or 1) indicates that you want to activate or not the open tracking on the concerned message. This option overrides your tracking options set on your user account.

X-Mailjet-TrackClick

This boolean (0 or 1) indicates that you want to activate or not the click tracking on the concerned message. This option overrides your tracking options set on your user account.

X-MJ-MonitoringCategory

This header is related to the real-time monitoring. This header defines the name of the monitoring category the message will be attached to.

After creating your categories and alerts in our user interface, you can leverage the X-MJ-MonitoringCategory property to specify which category the message you are sending is related to:

X-MJ-MonitoringCategory: your_category_name_here

Find more info at dev.mailjet.com

X-Mailjet-Prio

The header manage the different types of email by defining up to four priority levels. More information

X-MJ-TemplateLanguage

This hearder is related to the processing of the template language. It activate the template language processing. By default the template language processing is deactivated. Use True to activate.

X-MJ-TemplateID

This header allows to pass the ID of the template stored on the Mailjet system.

X-MJ-Vars

This hearder allows to pass a JSON encoded array of variables that can be used with the templating language.

Example: {“varname1”: “value1”,“varname2”: “value2”, “varname3”: “value3”}

X-MJ-TemplateErrorReporting

This hearder is related to the processing of the template language. This header defines the email address where a carbon copy with error message is sent to.

X-MJ-TemplateErrorDeliver

This hearder is related to the processing of the template language. This header defines if the message is delivered when an error is discovered in the templating language. By default the delivery is deactivated. Use deliver to let the message be delivered to the recipient, 0 to stop it.

Find more information on Custom Headers at dev.mailjet.com

Try Mailjet now ?
Create an account - no engagement, no hidden fees