Skip to main content
Logs show what happened to every message: who got it, which provider carried it, what it said, and whether it was delivered, opened, or clicked. Journey logs do the same for each step of a run. Search them in the Courier dashboard, no code needed, or fetch the same records over the API or MCP.

Message logs

The Messages tab of Logs lists every message in the current environment, newest first. Each row shows the message’s status, template, recipient, and the channels it went out on.
The message logs list

Find a message or a recipient

The histogram at the top shows message volume per day, colored by status. Drag across it to filter the list to that date range.
The logs histogram, with daily message volume colored by status
Filter the list by any combination of: The requestId the Send API returns is the message ID. It’s the same ID the GET /messages/{message_id} endpoint and outbound webhooks use.

Read a message

Select a message to open its detail view:
  • Summary: the message ID, the recipient ID, and a timestamp for each stage, such as enqueued, sent, and first delivery.
  • Timeline: every event in the message’s life, in order. Select an event to see its details, including the provider’s raw response.
A message's detail view, with the summary above the timeline of events
When a message fails, the timeline has an Error Encountered event. Select it to read the error.
The Error Encountered event open in the timeline, showing the error message
A message’s status only moves forward. DELIVERED comes from your provider, and OPENED and CLICKED come from Courier’s own tracking, so a message can show an open before its delivery is confirmed. Message statuses and errors lists every status, and Tracking explains which channels report opens and clicks.

See the rendered content

Teammates with Full log access see the rendered message in the dashboard. To get it in code, call GET /messages/{message_id}/output. It returns what the recipient received, per channel: the subject, HTML, and text body for email, and the message text for SMS and push.

Journey logs

Every time a journey is invoked, Courier records a run: the full trace of that journey for that user, identified by the runId the invoke call returns. Open a journey and select its Logs tab to see its runs. To see runs across every journey, open the Journeys tab of the Logs page, which adds a template ID column. Over the API, GET /journeys/runs lists runs and GET /journeys/runs/{run_id}/steps returns each step a run took.
A journey's Logs tab listing its runs

Find a run

Search by run ID or template ID, or filter by status, date range, or recipient. A run has one of these statuses:

Read a run

Select a run to see it on the journey canvas, with each node marked by what happened to it. The view shows which nodes ran and in what order, which path each branch took, where a waiting run is paused, and which node failed.
A run shown on the journey canvas, with the outcome marked on each node
Select a node to see its step context: Step context answers most “why” questions. If a branch took the wrong path, the conditions show the value it compared, such as data.plan being free instead of pro. If a send failed, the profile shows the missing field, such as an empty email.
The step context for one node, showing its input data, profile, and output
Over the API, every step that GET /journeys/runs/{run_id}/steps returns carries the same reason. error.message is set on a failed step, such as Fetch failed: GET api.example.com returned 404. skip_reason is set on a skipped step, such as Node conditions not met. Both are null otherwise. A run always shows the journey version it started on, even after you publish changes, so you see what that user went through.

Read logs over the API or MCP

Everything in the Logs page is available over the API, for support tools, scripts, and AI agents: With the Courier MCP server connected, your AI agent can look up messages for you. Ask it something like “why didn’t Sarah Bennett get her receipt?” and it uses the list_messages, get_message, get_message_history, and get_message_content tools to find the message and read its timeline.

Other logs

  • Broadcasts: each recipient gets their own entry in message logs. The per-recipient view for one broadcast is in Analytics.
  • Preference changes: open a user in Directory → Users and select their preference log to see when they opted in or out of each topic. Over the API, GET /preferences/logs returns the change history for one user or the whole environment.
  • Automations: runs for the previous workflow product are covered in Automations (Legacy).
  • Workspace changes: who changed which setting, and when, is in the audit trail.

Troubleshoot a message

If a message shows SENT and the recipient doesn’t have it:
  1. Open the SENT event in the timeline and read the provider’s response.
  2. Look the message up in your provider’s own activity log, such as SendGrid Activity or the SES console, for a bounce, block, or deferral.
  3. Check SPF, DKIM, and DMARC on your sending domain.
If a message shows DELIVERED and the recipient still doesn’t have it, the recipient’s mail server accepted it. A spam filter or security gateway on their side is the usual cause. Debug email delivery walks through each case.

Limits & behavior

  • SENT is not a failure. Courier handed the message to the provider and hasn’t heard back, which usually means delivery tracking isn’t set up for that provider. Set up delivery tracking to get DELIVERED.
  • Logs are per environment. Test messages appear only in Test logs.
  • Retention depends on your plan. Developer keeps 30 days of message history and Business keeps 90. Enterprise keeps 365 days by default, and Enterprise workspaces can configure retention. Searches and reads are clipped to that window, so export anything you need to keep longer. A message’s own event history is capped at roughly 93 days on every plan, so an older message still lists but returns no timeline.
  • Journey runs are kept for 95 days. After that, GET /journeys/runs/{run_id} returns 404.

FAQ

Search Courier’s message logs for the recipient’s email address or user ID and open the message. DELIVERED means the provider confirmed it, and SENT means Courier is still waiting to hear back.
The dashboard shows the rendered message to teammates with Full log access. Over the API, GET /messages/{message_id}/output returns the content per channel, including the subject and HTML for email.
Developer keeps 30 days of message history, Business keeps 90, and Enterprise keeps 365 days by default with configurable retention. A message’s own event history is capped at roughly 93 days on every plan.
Logs are in the Courier dashboard, and you search them by recipient, template, or status without writing code. On Enterprise, roles set how much a member sees. Some roles see no logs, Developer sees only the timeline in Production, and full logs add the event details, including the request data. See Role-based access control (RBAC) and SSO.
The requestId in your Send API response is the message ID. Fetch the message with it through the Messages API, or match it to message:updated webhook events.
Courier records opens and clicks the moment they happen. DELIVERED waits for the provider’s confirmation, which can take minutes or never arrive.
The invoke call returns a runId. Pass it to GET /journeys/runs/{run_id} for the run, and to GET /journeys/runs/{run_id}/steps for each step it took. In the dashboard, search for it in the journey’s Logs tab.
A run shows the version that was published when it started, not your latest draft.