# Send emails with Symfony

## Prerequisites

Before you start, you'll need:

- A Resend [API key](/guides/get-started-create-an-api-key)
- A [verified domain](/guides/get-started-add-a-domain)

## Guide

::::steps
:::step{title="Install"}
Get the Resend Mailer Bridge package.

```bash Composer theme={"theme":{"light":"github-light","dark":"vesper"}}
composer require symfony/resend-mailer
```

If your application relies on Resend webhook events, also install the Symfony Webhook Component.

```bash Composer theme={"theme":{"light":"github-light","dark":"vesper"}}
composer require symfony/webhook
```
:::

:::step{title="Configuring Mailer"}
In your `.env.local` file, which you can create if needed, add the following:

```sh theme={"theme":{"light":"github-light","dark":"vesper"}}
MAILER_DSN=resend+api://API_KEY@default
MAILER_RESEND_SECRET=SIGNING_SECRET
```

Replace `API_KEY` with your Resend API key, and `SIGNING_SECRET` with your webhook secret, which can be retrieved from the Resend dashboard after creating a new webhook endpoint (see below).
:::

:::step{title="Send your first email"}
In a controller, inject the `Mailer`:

```php theme={"theme":{"light":"github-light","dark":"vesper"}}
public function __construct(
    private readonly MailerInterface $mailer,
) {
}
```

In a controller action, use the `$this->mailer` to send your email:

```php theme={"theme":{"light":"github-light","dark":"vesper"}}
$this->mailer->send(
    (new Email())
        ->from('Acme <onboarding@resend.dev>')
        ->to('delivered@resend.dev')
        ->subject('Hello world')
        ->html('<strong>it works!</strong>')
);
```

Learn more about sending emails with Mailer Component in [Symfony's documentation](https://symfony.com/doc/current/mailer.html#creating-sending-messages).
:::

:::step{title="Receive and handle webhooks"}
Thanks to the Webhook Component, you can create a webhook listener.

```php src/Webhook/ResendWebhookListener.php theme={"theme":{"light":"github-light","dark":"vesper"}}
#[AsRemoteEventConsumer('mailer_resend')]
readonly class ResendWebhookListener implements ConsumerInterface
{
    public function __construct(
        #[Autowire(param: 'kernel.project_dir')] private string $projectDir,
    ) {
    }

    public function consume(RemoteEvent $event): void
    {
        if ($event instanceof MailerDeliveryEvent) {
            $this->handleMailDelivery($event);
        } elseif ($event instanceof MailerEngagementEvent) {
            $this->handleMailEngagement($event);
        } else {
            // This is not an email event
            return;
        }
    }

    private function handleMailDelivery(MailerDeliveryEvent $event): void
    {
        // Todo
    }

    private function handleMailEngagement(MailerEngagementEvent $event): void
    {
        // Todo
    }
}
```

Bind your listener to the Webhook routing config:

```yaml config/packages/webhook.yaml theme={"theme":{"light":"github-light","dark":"vesper"}}
framework:
  webhook:
    routing:
      mailer_resend:
        service: 'mailer.webhook.request_parser.resend'
        secret: '%env(MAILER_RESEND_SECRET)%'
```

Next, register your application's webhook endpoint URL (example: `https://{app_domain}/webhook/mailer_resend`) in the [Resend Dashboard](https://resend.com/webhooks):
:::
::::

## Examples

::::card-grid
:::card{title="Symfony App" href="https://github.com/resend/resend-examples/tree/main/php-resend-examples/symfony_app" icon="arrow-up-right-from-square"}
Full Symfony web application
:::

:::card{title="Basic Send" href="https://github.com/resend/resend-examples/tree/main/php-resend-examples/src/send" icon="arrow-up-right-from-square"}
Basic, batch, and prevent-threading send
:::

:::card{title="Attachments" href="https://github.com/resend/resend-examples/tree/main/php-resend-examples/src/attachments" icon="arrow-up-right-from-square"}
File attachments and inline images (CID)
:::

:::card{title="Scheduling" href="https://github.com/resend/resend-examples/tree/main/php-resend-examples/src/scheduling" icon="arrow-up-right-from-square"}
Schedule emails for future delivery
:::

:::card{title="Templates" href="https://github.com/resend/resend-examples/tree/main/php-resend-examples/src/templates" icon="arrow-up-right-from-square"}
Send emails using Resend hosted templates
:::

:::card{title="Double Opt-in" href="https://github.com/resend/resend-examples/tree/main/php-resend-examples/src/double-optin" icon="arrow-up-right-from-square"}
Double opt-in subscription flow
:::

:::card{title="Inbound Webhooks" href="https://github.com/resend/resend-examples/tree/main/php-resend-examples/src/inbound" icon="arrow-up-right-from-square"}
Receive and process inbound emails
:::

:::card{title="Audiences" href="https://github.com/resend/resend-examples/tree/main/php-resend-examples/src/audiences" icon="arrow-up-right-from-square"}
Manage contacts and audiences
:::

:::card{title="Domains" href="https://github.com/resend/resend-examples/tree/main/php-resend-examples/src/domains" icon="arrow-up-right-from-square"}
Create and manage sending domains
:::
::::

## Related pages

- [Send emails with PHP](./get-started-send-with-php.md)
- [Send emails with Laravel](./get-started-send-with-laravel.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.