Mail logs

Mail logs are the source of truth for every email Mailofly attempts to deliver — recipient, subject, status, timestamps, and error details. In the app: Emails

What’s logged

Each row represents one recipient in one send attempt:

Field	Description
`to_email`	Recipient address
`subject`	Rendered subject (merge tags resolved)
`body_html`	Rendered HTML body
`status`	Current delivery state
`from_email`	Sender address used
`account_id`	Which sending account delivered
`campaign_id`	Campaign (null for Compose sends)
`campaign_run_id`	Which campaign run
`contact_id`	Linked contact record
`sent_at`	When delivery completed
`error`	Failure message from SMTP/provider
`smtp_message_id`	Provider message ID

Status lifecycle

pending → sending → sent
                 ↘ failed
                 ↘ deferred (quota — retries tomorrow)
                 ↘ halted

Status	Meaning	Action
`pending`	Queued, not yet picked up	Wait — refresh the page
`sending`	Currently being delivered	Wait
`sent`	Handed off successfully to provider	✓ Done
`failed`	SMTP or provider rejected	Read `error` field — fix credentials, DNS, or content
`deferred`	Daily account quota hit	Sends tomorrow automatically
`halted`	Manually stopped or system halt	Investigate campaign state

Debug a failed send

Open Emails
Filter by status: failed or search the recipient email
Click the row to open the detail panel
Read the error message — common causes:

Error pattern	Likely fix
Authentication failed	Check SMTP username/password or re-auth Google
SPF/DKIM fail	Verify DNS records
Rate limit / quota	Lower volume or add accounts
Invalid recipient	Check email format / suppression

Filters

Filter	Use case
Search	Find a specific email address
Campaign	All sends for one blast
Account	Debug one sending identity
Status	Isolate failures or deferred rows
Campaign run	Compare runs of the same campaign

API

curl -sS "https://api.mailofly.com/v1/mail-logs?status=failed&page=1&page_size=50" \
  -H "Authorization: Bearer mf_live_…" \
  -H "Accept: application/json"

Query parameters: page, page_size (max 100), campaign_id, account_id, status, campaign_run_id. Full reference: API: Mail logs

Retention

Log storage depends on your plan:

Plan	Stored logs	Retention
Free	5,000 rows	3 days
Basic	25,000 rows	14 days
Scale	500,000 rows	30 days

Older logs are pruned automatically. Export via API if you need long-term archives.

Campaigns — run history
Sending accounts — quota and deferral
Integrations → Webhooks — signed outbound event notifications

Get started

Learn

Resources

Mail logs

Mail logs

What’s logged

Status lifecycle

Debug a failed send

Filters

API

Retention

​Mail logs

​What’s logged

​Status lifecycle

​Debug a failed send

​Filters

​API

​Retention

​Related

Mail logs

What’s logged

Status lifecycle

Debug a failed send

Filters

API

Retention

Related