September 18, 2017

SMTP Message Tag

You can add an array of strings to tag the message with. Stats are accumulated using tags, though we only store the first 100 we see, so this should not be unique or change frequently. Tags should be 50 characters or less. Any tags starting with an underscore are reserved for internal use and will cause errors.

To tag your message sent via SMTP request you need to add a custom header.

Important! To use tags in your campaigns and view detailed analytics based on them, you need to register the tags in the system. You can find more details about tag registration in our article.

Header	Purpose	Format	Example
X-Tags	Add tags to the outgoing message	Array of strings in JSON-format shielded with backslashes, each string being a tag to apply to the message. No more than 30 characters per tag and 100 tags per account A tag has its own syntax rules, namely: The tag name may contain only numbers, Latin or Cyrillic characters, and the following symbols: `[.]`, [`-]`, `[_]`. The tag name length must be between 2 and 30 characters.	X-Tags: [\”tag1\”, \”tag2\”] Example PHP: addslashes(json_encode([‘tag1’, ‘tag2’, ‘tag3’]));
X-Message-Priority	Add priority tag to the outgoing emails to avoid delivery delays for important messages due to large promo campaigns in queue	Priority 1 is default value. You can have up to 5 priority levels. Priority level over 5 will be rounded to 5	Example: X-Message-Priority: 2
X-Header	Optional extra headers added to the message.	String format	Example: X-Header: “TemplateExample”
X-Ignore-Hard	By setting the X-Ignore-Hard filter to true, your message will bypass the bounce list. The spam report and global unsubscribe lists will be checked and respected.		Example: X-Ignore-Hard: “true”
X-Ignore-Complaint	By setting the X-Ignore-Complaint filter to true, your message will bypass the spam report list. The bounce and global unsubscribe lists will be checked and respected.		Example: X-Ignore-Complaint: “true”
X-Ignore-Unsubscribe	By setting the X-Ignore-Unsubscribe filter to true, your message will bypass the global unsubscribe list. The spam report and bounce lists will be checked and respected.		Example: X-Ignore-Unsubscribe: “true”
X-Ignore-Blacklist	By setting the X-Ignore-Blacklist filter to true, your message will bypass all unsubscribes and suppressions in all lists. X-Ignore-Blacklist filter cannot be combined with any other bypass lists.`IMPORTANT`That parameter is only available for Enterprise Plan. Request the parameter activation from the support team via support@wooxy.com.		Example: X-Ignore-Blacklist: “true”