Message Tags

Label every message with your own metadata

mailkube message tags let you attach your own metadata to any outgoing email. Pass an array of name and value pairs on a send, and mailkube carries them through the whole lifecycle of the message. Tag by campaign, tenant, feature, or environment. There is no schema to define and no setup to do.

Tags on a send

curl -X POST https://api.mailkube.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "from": "noreply@yourdomain.com",
    "subject": "Your order has shipped",
    "html": "<h1>On its way!</h1><p>Track your order at...</p>",
    "tags": [
      { "name": "campaign", "value": "spring-sale" },
      { "name": "tenant", "value": "acme" }
    ]
  }'

The same tags work over SMTP, so you can label messages without changing how you send. Add as many tags as you need on a single message.

What tags give you

• Filter your sending logs. Narrow your log view to a single tag to see every message sent for one campaign, one customer, or one release.
• Dashboard breakdown. The dashboard groups your sending volume by tag, so you can see which campaigns or tenants drive the most email and how each is delivering.
• Tags in every webhook. Delivery, open, click, and bounce events carry the same tags you set at send time. Route events by tenant or attribute engagement to a campaign without a lookup.
• No schema. A tag is just a name and a value. You decide what they mean, and mailkube keeps them attached from send to delivery.

What’s next

• Read the API Reference for the tag object schema and the webhook payload format
• Set up SMTP to tag messages without an API integration
• Follow Getting started to send your first tagged email in minutes