Docs/Analytics

Analytics

Track email performance with built-in analytics. Monitor delivery rates, open rates, bounces, and click activity from the dashboard or API.

Overview Endpoint

GET/api/analytics/overview?days=30

Returns aggregate metrics for the specified time period.

FieldTypeDescription
totalnumberTotal emails sent
deliverednumberSuccessfully delivered
openednumberEmails opened (tracking pixel)
bouncednumberBounced emails
complainednumberMarked as spam
failednumberFailed to send
pendingnumberStill processing
deliveryRatenumberPercentage of successful deliveries
openRatenumberPercentage of opens (of delivered)
Example response
{
  "total": 1250,
  "delivered": 1200,
  "opened": 480,
  "bounced": 35,
  "complained": 2,
  "failed": 13,
  "pending": 0,
  "deliveryRate": 96.0,
  "openRate": 40.0
}

Timeline Endpoint

GET/api/analytics/timeline?days=30&groupBy=day
ParameterTypeRequiredDescription
daysnumberOptionalTime period in days (default: 30)
groupBystringOptional"day" or "week" (default: "day")

Returns time-series data with metrics grouped by day or week.

Tracking Features

Open Tracking

A 1×1 invisible tracking pixel is automatically injected before the closing </body> tag in HTML emails. When the recipient loads images, the open is recorded.

Click Tracking

In batch emails, links are automatically replaced with tracked short URLs powered by Shrnk. Click data includes total clicks per link and is available in the batch detail view.

Bounce Handling

Bounced email addresses are automatically added to a global suppression list. Future sends to bounced addresses are blocked to protect your sender reputation. You receive a webhook notification with bounce details.

Unsubscribe Tracking

CAN-SPAM compliant unsubscribe links are automatically injected into batch emails. When a recipient unsubscribes, an email.unsubscribed webhook event is fired.