Skip to main content
Tags label a message with what it is, such as password-reset, invoice or onboarding. You can then filter your messages by tag, for example to see how all invoice emails were delivered last week. Available on Free, Pro and Max. See plans and features.

How do I tag an email?

Add a tags array to the send request:

How do I find messages by tag?

List Messages takes a tags filter with up to 20 comma-separated tags:

How should I name tags?

Name tags after what the email is, not after the recipient: a tag per user makes filtering useless. Lowercase with hyphens works well, such as password-reset, order-confirmation or trial-ending. Over SMTP, use the ahasend-tags special header with the same rules.