wp_mail_failed │ action-hook │ WP 4.4.0

Fires after a PHPMailer exception is caught.

Usage

add_action( 'wp_mail_failed', 'wp_kama_mail_failed_action' );

/**
 * Function for `wp_mail_failed` action-hook.
 * 
 * @param WP_Error $error A WP_Error object with the PHPMailer\PHPMailer\Exception message, and an array containing the mail recipient, subject, message, headers, attachments, and embeds.
 *
 * @return void
 */
function wp_kama_mail_failed_action( $error ){

	// action...
}

$error(WP_Error)

A WP_Error object with the PHPMailer\PHPMailer\Exception message, and an array containing the mail recipient, subject, message, headers, attachments, and embeds.

Changelog

Where the hook is called

do_action( 'wp_mail_failed', new WP_Error( 'wp_mail_failed', $e->getMessage(), $mail_data ) );

do_action( 'wp_mail_failed', new WP_Error( 'wp_mail_failed', $e->getMessage(), $mail_error_data ) );

Where the hook is used in WordPress