Skip to content

Delivery lifecycle

What happens after a send attempt: the log entry, delivered / failed / finally-failed events, the queue, simulation mode and the test-email tool.

HookKindTierSinceSummary
boolean_smtp_email_delivery_failed_finalactionA1.0.0Fires when a mail delivery attempt has failed with no further fallback to try.
boolean_smtp_email_event_datafilterA1.0.0Filters the data describing a mail delivery event before it is announced and used to build a notification.
boolean_smtp_email_failedactionA1.0.0Fires after a send attempt has failed, before the fallback connection is tried.
boolean_smtp_email_log_deletedactionB1.0.0Fires after an email log entry has been deleted.
boolean_smtp_email_loggedactionB1.0.0Fires after an email log entry has been created.
boolean_smtp_email_queuedactionA1.0.0Fires after an email has been added to the queue.
boolean_smtp_email_sentactionA1.0.0Fires after a message has been delivered successfully.
boolean_smtp_log_retention_daysfilterA1.0.0Filters the number of days email logs are kept before the daily cleanup removes them.
boolean_smtp_process_queueaction (WP-Cron)B1.0.0Fires every minute while the email queue is enabled; each run sends one batch of queued messages.
boolean_smtp_prune_logsaction (WP-Cron)B1.0.0Fires daily; each run deletes the email log entries older than the retention period.
boolean_smtp_queue_batch_sizefilterB1.0.0Filters how many queued messages one worker run sends.
boolean_smtp_should_notify_delivery_failurefilterA1.0.0Filters whether a final delivery failure is announced and notified.
boolean_smtp_should_store_smtp_transcriptfilterB1.0.0Filters whether the SMTP transcript of a send is stored as a debug session file.
boolean_smtp_simulation_capturedactionA1.0.0Fires after a message has been captured by Email Simulation Mode instead of being sent.
boolean_smtp_test_email_sentactionA1.0.0Fires after the admin test-email tool has attempted a send.