Skip to main content
Every email dispatched by MailerPath generates a sent email record. Use these records to verify delivery, track engagement, and debug issues.

​
Sent email statuses

StatusMeaning
queuedEmail is waiting to be dispatched.
sentAccepted by the email provider.
deliveredConfirmed delivery by provider or webhook.
openedRecipient opened the email (tracking pixel fired).
clickedRecipient clicked a tracked link.
deferredProvider temporarily delayed delivery — will retry automatically.
bouncedHard or soft bounce received from provider.
failedDispatch failed after retries.
skippedContact was unsubscribed, suppressed, or rate-limited.

​
Where sent emails come from

Sent email records are created by:
  • Transactional send via POST /client/send
  • Workflow action steps that dispatch an email
  • Campaign sends to a batch of recipients
Each record is linked to its source: the campaign, workflow execution, or direct send request.

​
How status updates work

Initial status at creation is queued or sent. Status changes are driven by:
  • Email provider acknowledgment (delivery confirmation)
  • Inbound webhook events (open, click, bounce, complaint)
MailerPath processes these webhook events and updates the sent email record accordingly.

​
Filtering and searching sent emails

You can retrieve sent emails filtered by:
  • Contact ID
  • Status
  • Date range (from and to in RFC3339 format)
  • Campaign ID
Use GET /client/sent-emails to list records or GET /client/sent-emails/{id} to retrieve a specific one.

​
Reading a sent email record

Key fields to understand:
  • status and status_text: current delivery state and human-readable label.
  • provider_message_id: the ID returned by the email provider for cross-referencing delivery logs.
  • error_message: reason for failure if status is failed or bounced.
  • opened_at, clicked_at, delivered_at: timestamps for engagement milestones.
  • attempt_count and last_attempt_at: retry history for failed records.
  • contact_id and contact_email: the recipient linked to the record.

​
Troubleshooting delivery issues

Status shows deferred
  • The provider accepted the email but delayed delivery temporarily.
  • MailerPath will retry automatically.
  • If the email stays deferred for an extended period, check provider logs for rate limiting or recipient-side filtering.
Email not delivered
  • Check error_message on the sent email record.
  • Verify sender domain is verified in your provider settings.
  • Confirm the contact is subscribed.
Status stuck at queued
  • Check provider configuration under Settings.
  • Verify API key is enabled and has send permissions.
High bounce rate
  • Review contact import quality: see Contacts.
  • Audit the domain sending configuration.
Open rate unexpectedly low
  • Open tracking requires that the template includes the view in browser or tracking link.
  • Check template variable resolution for viewInBrowserUrl.
For common error patterns and fixes, see Common API issues.