formcierge_email_recipients

Filter

Since v1.0.0

Modify the list of email recipients for a notification. Use to add conditional CC addresses or route to different teams based on form data.

Parameters

$recipients array Array of email address strings.

$form_id int The form ID.

$entry_id int The entry ID.

Defined in

includes/Core/Mailer.php

Basic Usage

add_filter( 'formcierge_email_recipients', function ( $recipients, $form_id, $entry_id ) {
    $service = formcierge_get_entry_field( $entry_id, 'field_service' );
    if ( $service === 'billing' ) {
        $recipients[] = 'billing@mysite.com';
    }
    return $recipients;
}, 10, 3 );

Real-World Examples

Always BCC a compliance address

add_filter( 'formcierge_email_recipients', function ( $recipients, $form_id, $entry_id ) {
    $recipients[] = 'compliance@mysite.com';
    return $recipients;
}, 10, 3 );