Skip to main content

Overview

Groups are optional string arrays that categorize emails. Assign multiple groups per email to organize by type, campaign, product line, or any classification. Use groups to filter and analyze performance via the Stats API.

Features

  • Multiple groups per email: Assign an array of group names to a single email (e.g., ["transactional", "order-updates"]).
  • Flexible naming: Use any string naming convention.
  • Analytics filtering: Filter stats and analyze performance by category.
  • Optional: Omit groups if not needed.

Common Use Cases

Separating Transactional and Promotional Emails

or

Tracking Campaigns

Product Line Classification

Email Type Classification

Examples

Transactional Email

Promotional Email

Newsletter

Using Groups with the Stats API

Filter and analyze performance by group using the Get aggregated stats by group endpoint. Compare performance across email types, campaigns, or product lines.
Groups are case-sensitive. Use consistent naming conventions (e.g., always lowercase or always kebab-case) to avoid duplicate groups.
Groups are stored with each email message and included in webhook payloads. Filter webhook events by group in your application.