FluentSMTP icon
Email & Marketing

FluentSMTP hooks reference

  • By WPManageNinja
  • v2.4.5 New
  • Updated

FluentSMTP 2.4.5 has 7 actions and 29 filters, read directly from its source code on Nov 17, 2026. The list updates automatically when a new version is released.

How to use these hooks

Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.

functions.phpyour child theme
// Run your own code when FluentSMTP fires an action
add_action( 'wp_mail_failed', function( $error ) {
	// Your code runs here.
}, 10, 1 );

// Change a value FluentSMTP is about to use
add_filter( 'fluentsmtp_use_encrypt', function( $value ) {
	// Change $value here.
	return $value;
}, 10, 1 );

Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.

All hooks

  • app/Functions/helpers.php line 623 · used in 2 places
    /**
     * This filter is documented in wp-includes/pluggable.php
     */
    do_action( 'wp_mail_failed', new WP_Error('wp_mail_failed', $e->getMessage(), $mail_error_data) );
  • app/Functions/helpers.php line 962
    /**
     * Get the value of the 'use_encrypt' setting.
     */
    apply_filters( 'fluentsmtp_use_encrypt', 'yes' );
  • app/Functions/helpers.php line 799
    /**
     * Fires after PHPMailer is initialized.
     */
    do_action_ref_array( 'phpmailer_init', array(&$phpmailer) );
  • pre_wp_mail

    filter
    app/Functions/helpers.php line 363
    /**
     * Filters whether to preempt sending an email.
     */
    apply_filters( 'pre_wp_mail', null, $atts );
  • wp_mail

    filter
    app/Functions/helpers.php line 338
    /**
     * Filters the wp_mail() arguments.
     */
    apply_filters( 'wp_mail', compact('to', 'subject', 'message', 'headers', 'attachments', 'embeds') );
  • app/Functions/helpers.php line 710
    /**
     * Filters the default wp_mail() charset.
     */
    apply_filters( 'wp_mail_charset', $charset );
  • app/Functions/helpers.php line 694
    /**
     * Filters the wp_mail() content type.
     */
    apply_filters( 'wp_mail_content_type', $content_type );
  • app/Functions/helpers.php line 765
    /**
     * Filters the arguments for PHPMailer's addEmbeddedImage() method.
     */
    apply_filters( 'wp_mail_embed_args', array( 'path' => $embed_path, 'cid' => (string)$key, 'name' => basename($embed_path), 'encoding' => 'base64', 'type' => '', 'disposition' => 'inline', ) );
  • wp_mail_from

    filter
    app/Functions/helpers.php line 599
    /**
     * Filters the email address to send from.
     */
    apply_filters( 'wp_mail_from', $from_email );
  • app/Functions/helpers.php line 609
    /**
     * Filters the name to associate with the "from" email address.
     */
    apply_filters( 'wp_mail_from_name', $from_name );
  • app/Functions/helpers.php line 833
    /**
     * Fires after a successful email is sent using the wp_mail() function.
     */
    do_action( 'wp_mail_succeeded', $mail_data );
  • app/Hooks/Handlers/SchedulerHandler.php line 207 · used in 3 places
    do_action( 'fluentmail_email_sending_failed_no_fallback', $logId, $handler, $data );
  • app/Hooks/Handlers/AdminMenuHandler.php line 131 · used in 2 places
    apply_filters( 'fluent_mail_disable_dashboard_widget', false );
  • app/Http/Controllers/SettingsController.php line 787 · used in 2 places
    apply_filters( 'fluentsmtp_gapi_callback', 'https://fluentsmtp.com/gapi/' );
  • app/Hooks/Handlers/AdminMenuHandler.php line 351
    do_action( 'fluent_mail_loading_app' );
  • app/Services/Mailer/Providers/AmazonSes/Handler.php line 179
    apply_filters( 'fluent_mail_ses_primary_domain_only', true );
  • app/Functions/helpers.php line 45
    apply_filters( 'fluent_mail/manage_capability', 'manage_options' );
  • app/Services/ConnectionHealth.php line 237
    do_action( 'fluentmail_connection_health_failed', $newlyFailing );
  • app/Services/ConnectionHealth.php line 149
    apply_filters( 'fluentmail_connection_health_probe', true, $providerSettings );
  • app/Hooks/Handlers/AdminMenuHandler.php line 343
    apply_filters( 'fluentmail_disable_recommendation', false );
  • app/Services/Mailer/BaseHandler.php line 786
    apply_filters( 'fluentmail_email_sending_failed', $status, $logId, $this, $data );
  • fluent-smtp.php line 43
    do_action( 'fluentMail_loaded', $application );
  • app/Models/Logger.php line 891
    apply_filters( 'fluentmail_log_delete_batch_size', 2000 );
  • app/Http/Controllers/SettingsController.php line 149
    apply_filters( 'fluentmail_saving_connection_data', $data, $data['connection']['provider'] );
  • app/Hooks/Handlers/BulkSendSessionHandler.php line 81
    apply_filters( 'fluentmail_smtp_bulk_keep_alive', true );
  • app/Services/Mailer/BaseHandler.php line 809
    apply_filters( 'fluentmail_will_log_email', $isLogOn, $miscSettings, $this );
  • app/Services/Mailer/BaseHandler.php line 1289
    apply_filters( 'fluentsmtp_attachment_blocked_paths', $blockedPaths );
  • app/Functions/helpers.php line 591
    apply_filters( 'fluentsmtp_disable_from_name_email', false );
  • app/Http/Controllers/LoggerController.php line 161
    apply_filters( 'fluentsmtp_max_resend_recipients', 25 );
  • app/Models/Logger.php line 849
    apply_filters( 'fluentsmtp_resend_history_limit', 20 );
  • app/Services/Mailer/Providers/AmazonSes/Handler.php line 190
    apply_filters( 'fluentsmtp_ses_valid_senders', $addresses, $config );
  • app/Hooks/Handlers/AdminMenuHandler.php line 212
    apply_filters( 'fluentsmtp_skip_no_conflict', false );
  • app/Services/Mailer/Providers/Smtp2Go/Handler.php line 115
    apply_filters( 'fluentsmtp_smtp2go_api_url', $url, $region );
  • app/Services/Mailer/Providers/Smtp2Go/Handler.php line 53
    apply_filters( 'fluentsmtp_smtp2go_fastaccept', true );
  • app/Services/Converter.php line 193
    apply_filters( 'wp_mail_smtp_helpers_crypto_get_secret_key', $secret_key );
  • app/Services/Converter.php line 142
    apply_filters( 'wp_mail_smtp_helpers_crypto_stop', false );

Generated from FluentSMTP's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.

Can't find the right hook?

We can build the customisation for you. Describe what you need: