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
| 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 50 characters per tag and 100 tags per account |
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.
|
Example: X-Ignore-Blacklist: “true” |
|
