# boolean_smtp_mail_fallback

> Fires before a failed send is retried through the fallback connection.

Action · Tier A · Since 1.0.0



## Signature

```php
add_action( 'boolean_smtp_mail_fallback', $callback, 10, 1 );
```

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `$payload` | `array<string, mixed>` | Retry payload: to, subject, message, headers, attachments, fallback_id. |

## Fires in

- [app/Services/Mailer/MailFailureHandler.php:185](https://github.com/booleanpress/boolean-smtp-src/blob/main/app/Services/Mailer/MailFailureHandler.php#L185) — `BooleanSmtp\Services\Mailer\MailFailureHandler::handle()`

## Example

```php
add_action( 'boolean_smtp_mail_fallback', function ( array $payload ) {
    // React to the event.
}, 10, 1 );
```