Use Tags API to retrieve, analyze, and aggregate performance data for tagged emails.
Overview
The Tags API helps you discover, analyze, and report on message tags used across your email communications. Tags act as structured labels attached to emails, templates, or campaigns, enable better categorization.
This API is designed to help teams move beyond campaign-level reporting and measure performance at a tag level; such as content type, feature name, product line, or lifecycle stage.
The Tags API allows you to:
- Retrieve all tags configured or used in your account
- Measure performance metrics tied to specific tags
- Access aggregated statistics across all tags
- Build reporting and dashboards around tagged communications
- Enable deeper campaign and content performance analysis
Who Should Use This API
This API is especially useful for:
- Developers building reporting or analytics dashboards
- Product and marketing teams tracking tagged campaign performance
- Data teams aggregating engagement metrics
- Automation systems that rely on tag-based reporting
Use the Tags API when you want structured, tag-level visibility instead of only campaign-level metrics.
Endpoints
Refer to the given table to know the available endpoints in Tags API.
| Endpoint | Purpose | When to Use |
|---|---|---|
| Get List of Tags | Retrieve all available tags associated with your account | • Discover existing tags • Validate tag names before reporting • Populate dashboard or tool filters • Build tag-based workflows |
| Stats for Tags | Fetch performance or usage statistics for individual tags | • Measure engagement for a specific tag • Compare tagged message groups • Track campaign or feature tags • Analyze content category performance |
| Total Sum of Tag Stats | Retrieve aggregated statistics across all tags | • Generate summary reports • Measure overall tagged-email performance • Build executive dashboards • Benchmark tag-driven messaging |
Use Case: Tag-Based Performance Tracking
Scenario: A marketing team tags emails with labels like onboarding, promo, and feature-update to measure how different content types perform.
Workflow:
- Get available tags: Use Get List of Tags API to fetch all tag names and populate dashboard filters.
- Check tag performance: Use Stats for Tags API to see engagement metrics for selected tags and compare results.
- Build summary reports: Use Total Sum of Tag Stats API to get overall tagged-email performance for leadership reporting.
Outcome: Developers can quickly enable tag-level analytics, helping teams understand which content categories drive the best results and optimize future campaigns.
How the Endpoints Work Together
- Get List of Tags: Discover and validate available tags
- Stats for Tags: Measure performance per tag
- Total Sum of Tag Stats: Generate overall tag analytics