Skip to main content
To attribute an SMTP send to a mailing-list topic, add an X-Mailkube-Topic header carrying the topic slug. An opt-out topic filters recipients who unsubscribed from it; an opt-in topic tags the send for reporting without filtering. The header is stripped before the message reaches the recipient. The header value is slugified before matching, so Product News and product-news reach the same topic. The stored slug is not always the name lowercased: a name over 16 characters is truncated at creation, and a collision on the apex gets a numeric suffix. Read the slug off the dashboard.

Example

Send with swaks, attributing the message to the newsletter topic:
--tls requires STARTTLS and fails rather than falling back to plaintext. The command puts these headers on the wire:
If newsletter is an opt-out topic and [email protected] unsubscribed from it, the message is accepted but silently dropped for that recipient (it still counts against your quota, the same path as a suppressed hard-bounce address).
An unknown or disabled topic is rejected with 550 5.7.1 before your quota is charged. See Error codes. A topic slug longer than 16 characters cannot name a topic and is refused with a 550 5.6.0 reply.
See Topics for opt-in vs opt-out behavior and how recipients manage their preferences.