Skip to main content
To attach free-form tags to an SMTP send, add an X-Mailkube-Tags header carrying a JSON array of { "name": ..., "value": ... } pairs. Tags are for your own filtering and reporting; they are excluded from aggregate metrics. The header is stripped before the message reaches the recipient.

Example

Submit it with curl. Uploading a file keeps the JSON on a single unfolded line, which a shell-quoted header argument makes easy to get wrong:
The header must be a JSON array. Anything else, invalid JSON included, is refused with 550 Invalid X-Mailkube-Tags JSON, and a raw header over 16 KB with 552 X-Mailkube-Tags header too large. An entry that breaks the tag rules (a bad character, an oversized name or value, a missing value key, a duplicate name, or more than 20 tags) is refused with a 550 5.6.0 reply whose text names the rule. See Error codes. A well-formed header is stripped before delivery.
Tag values are not encrypted and are excluded from aggregate metrics, so never put personal data (a recipient address, a name, anything identifying) in a tag name or value.
See Tag your emails for the same tags on the REST send API.