Skip to main content
Courier tracks every message from API request through routing, rendering, provider handoff, delivery, and engagement. That data surfaces in three places:
  • Analytics: how each template performs, by channel and provider, over a time window. The same numbers are available per template through the Template Metrics API, so you can chart them in your own tools.
  • Message Logs: the full timeline and rendered content of a single send, for debugging.
  • Audit Trail: who changed what in the workspace, and when.

​
Key concepts

​
Message statuses

Every message moves through the same lifecycle. Analytics counts these statuses per template, and Message Logs show them per message.

​
Environment isolation

Analytics and logs are scoped to the environment (Production or Test) of the API key used to send. Sends made with a Test key only appear in the Test dashboard, and vice versa.

​
How far back you can look

Each plan sets how much history you can query, and the limits differ between analytics and logs: Limits are enforced server-side. A Metrics API request that reaches past your plan’s lookback returns a 402 rather than a partial result. See Log Retention for the log details.

​
Common workflows

Debug a failed send. Open Message Logs and filter by recipient, status, or time range. Each entry shows the timeline of events (enqueued, routed, sent, delivered) and the rendered content that went to the provider. If a send failed, the log tells you where and why. Compare channel performance. Open Analytics, pick a time range, and click into a template to see sends, delivery, opens, clicks, and errors split by channel and provider. Use it to decide whether email or push is doing the work for a given template, or to spot a provider with an unusually high error rate. Build your own dashboard. Call the Template Metrics API to pull a template’s metrics as a time series, bucketed by hour, day, week, or month. Feed it into a BI tool, alert on a falling delivery rate, or give an agent a way to answer “how is this template doing?” The endpoint reference is Get notification template metrics. Audit workspace changes. The Audit Trail records API key rotations, user invitations, integration updates, template publications, and other configuration changes. Use it for compliance reporting or to trace an unexpected change. Track engagement on your own domain. If you use a custom domain for email tracking links, set it up in Custom Domain Tracking so open and click events resolve to your brand instead of Courier’s default domain.