PHPackages etailors/mautic-amazon-ses - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. etailors/mautic-amazon-ses ActiveMautic-plugin[Mail & Notifications](/categories/mail) etailors/mautic-amazon-ses ========================== Amazon SES Mailer Plugin for Mautic 1.0.36(3w ago)574.2k↑36.7%45[2 issues](https://github.com/pm-pmaas/etailors_amazon_ses/issues)GPL-3.0-or-laterPHPPHP >=8.1.0 Since Apr 14Pushed 3w ago5 watchersCompare [ Source](https://github.com/pm-pmaas/etailors_amazon_ses)[ Packagist](https://packagist.org/packages/etailors/mautic-amazon-ses)[ RSS](/packages/etailors-mautic-amazon-ses/feed)WikiDiscussions main Synced 3d ago READMEChangelog (10)Dependencies (20)Versions (96)Used By (0) Mautic AWS SES Plugin with SNS Callback ======================================= [](#mautic-aws-ses-plugin-with-sns-callback) This plugin provides integration between [Mautic 5, 6 and 7](https://www.mautic.org) and [Amazon SES](https://aws.amazon.com/ses/) for sending emails through AWS. It also integrates with [Amazon SNS](https://aws.amazon.com/sns/) for handling email feedback such as bounces and complaints via callbacks. (PHP >= 8.1 required; Note: Mautic 7 itself requires PHP 8.2) This is a custom plugin inspired by the structure of: - [mabumusa1/ses-plugin](https://github.com/mabumusa1/ses-plugin) - [ts-navghane/sparkpost-plugin](https://github.com/ts-navghane/sparkpost-plugin) Feel free to suggest improvements or provide feedback — this is my first Mautic plugin and community contributions are welcome. --- Features -------- [](#features) - Send emails through Amazon SES using the API. - Support for setting AWS regions and optional custom rate limits in the DSN. - Integration with Amazon SNS to process bounces and complaints via callback. - Built-in **rate limiting** to honor SES sending quotas. - Dynamic **batch size** matching the current SES max send rate. - Auto-fetch and cache your SES sending quota. - Manual override of rate limit with `ratelimit` DSN option. - Optional retry handling for partial email failures. --- Installation ------------ [](#installation) ### 1. Download and Install the Plugin [](#1-download-and-install-the-plugin) #### Install manual [](#install-manual) 1. Download or clone the repository to your Mautic plugins directory: ``` cd /path/to/your/mautic/plugins git clone https://github.com/yourusername/mautic-aws-ses-plugin.git AmazonSesBundle ``` 2. Clear Mautic’s cache: ``` php /path/to/mautic/bin/console cache:clear ``` 3. Go to **Mautic Settings > Plugins** and click the “Install/Update Plugins” button. --- #### Install via Composer [](#install-via-composer) If you prefer installing via Composer, run the following command from your Mautic root directory: ``` composer require etailors/mautic-amazon-ses:^1.0 -W ``` Version number Then clear the cache and reload the plugins: ``` rm -rf var/cache/* php bin/console mautic:plugins:reload ``` > **Note:** > The plugin will automatically install into `plugins/AmazonSesBundle`. --- ### 2. Configure Amazon SES Settings [](#2-configure-amazon-ses-settings) 1. In Mautic, navigate to **Settings > Email Settings**. 2. Select the newly installed **AWS SES** option. 3. In the **DSN** field, enter your connection string in the following format: ``` mautic+ses+api://:@default?region=&ratelimit=14 ``` - Replace `` and `` with your AWS credentials. - Replace `` with your AWS region (e.g., `us-east-1`). - Optionally set `ratelimit` to override the SES max send rate manually. 4. Set the region in the `options` parameter, for example: ``` Label: region Value: eu-west-1 ``` [![Amazon SES Integration](https://github.com/pm-pmaas/etailors_amazon_ses/raw/1.0.1/Assets/img/mautic-ses-dsn.png)](https://github.com/pm-pmaas/etailors_amazon_ses/blob/1.0.1/Assets/img/mautic-ses-dsn.png) --- ### 3. AWS SES Configuration [](#3-aws-ses-configuration) 1. Ensure that you have verified your domain and email addresses in AWS SES. 2. Set up the appropriate IAM user with permissions to send emails via SES. **Please make sure you create a new IAM user directly via IAM instead of upgrading an SMTP user with the permission: sending via SES API.** There are known issues when upgrading SMTP-only users — see: [issue #28](https://github.com/pm-pmaas/etailors_amazon_ses/issues/28). Your IAM user must have permission to send and get account limits. Here’s an example policy: ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSesSendingAndQuota", "Effect": "Allow", "Action": [ "ses:SendEmail", "ses:SendRawEmail", "ses:GetSendQuota" ], "Resource": [ "arn:aws:ses:::identity/*", "arn:aws:ses:::configuration-set/*" ] } ] } ``` --- ### 4. Available Regions [](#4-available-regions) ``` af-south-1 ap-northeast-1 ap-northeast-2 ap-south-1 ap-southeast-1 ap-southeast-2 ca-central-1 eu-central-1 eu-north-1 eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-east-2 us-gov-west-1 us-west-1 us-west-2 ``` --- SNS Callback Configuration -------------------------- [](#sns-callback-configuration) To receive feedback from Amazon SES regarding bounces and complaints, you need to set up Amazon SNS. 1. Go to your [Amazon SNS Dashboard](https://console.aws.amazon.com/sns/v3/home). 2. Create a new **Topic** (or use an existing one) for SES feedback. 3. Subscribe to this topic with an **HTTPS endpoint** using the following URL: ``` https:///mailer/callback ``` 4. Ensure your topic sends notifications for bounces, complaints, and delivery status. 5. Test your callback configuration by sending test emails and reviewing Mautic logs to verify feedback is processed correctly. --- Batch Limit & Throttling ---------------------------- [](#batch-limit--throttling) To avoid exceeding SES rate limits, this plugin automatically: - Caches the current `maxSendRate` returned by AWS SES. - Dynamically adjusts the batch size to match that rate. - Throttles outgoing email API calls using `usleep()`. - Allows overriding the send rate via `ratelimit` DSN option. This prevents common errors like `TooManyRequests` while maximizing throughput. --- Debugging --------- [](#debugging) - To troubleshoot email sending or SNS callback issues, check Mautic’s logs: ``` /path/to/mautic/var/logs ``` - You can also monitor SES and SNS performance in **Amazon CloudWatch**. --- Contributions & Feedback ---------------------------- [](#contributions--feedback) This is my first Mautic plugin, so I’m open to any feedback or improvements. Feel free to open an issue or submit a pull request if you find a bug or have a feature request! --- License ------- [](#license) This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details. --- Changelog --------- [](#changelog) See [CHANGELOG.md](CHANGELOG.md) for release notes. Version 1.0.31 maintains compatibility with PHP 8.1 for Mautic 6 users, while supporting Mautic 7 (which requires PHP 8.2). ### Health Score 59 — FairBetter than 98% of packages Maintenance94 Actively maintained with recent releases Popularity40 Moderate usage in the ecosystem Community26 Small or concentrated contributor base Maturity66 Established project with proven stability Bus Factor1 Top contributor holds 81.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~11 days Recently: every ~5 days Total 71 Last Release 24d ago PHP version history (2 changes)1.0.0PHP >=8.0.0 1.0.31-beta1PHP >=8.1.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/945c2e499eab80ddf68b1a61089a161dd61ac5bdb35c2a95a7d7cc260e79bd53?d=identicon)[pm-pmaas](/maintainers/pm-pmaas) --- Top Contributors [![pm-pmaas](https://avatars.githubusercontent.com/u/17729447?v=4)](https://github.com/pm-pmaas "pm-pmaas (170 commits)")[![lenonleite](https://avatars.githubusercontent.com/u/218436?v=4)](https://github.com/lenonleite "lenonleite (9 commits)")[![JonasLudwig1998](https://avatars.githubusercontent.com/u/146742086?v=4)](https://github.com/JonasLudwig1998 "JonasLudwig1998 (6 commits)")[![BuggerSee](https://avatars.githubusercontent.com/u/36350532?v=4)](https://github.com/BuggerSee "BuggerSee (5 commits)")[![synapdk](https://avatars.githubusercontent.com/u/37423570?v=4)](https://github.com/synapdk "synapdk (4 commits)")[![adiux](https://avatars.githubusercontent.com/u/13075514?v=4)](https://github.com/adiux "adiux (3 commits)")[![matbcvo](https://avatars.githubusercontent.com/u/1006437?v=4)](https://github.com/matbcvo "matbcvo (2 commits)")[![dlackovic2](https://avatars.githubusercontent.com/u/68977388?v=4)](https://github.com/dlackovic2 "dlackovic2 (2 commits)")[![kuzmany](https://avatars.githubusercontent.com/u/462477?v=4)](https://github.com/kuzmany "kuzmany (1 commits)")[![AleksKeller](https://avatars.githubusercontent.com/u/234598594?v=4)](https://github.com/AleksKeller "AleksKeller (1 commits)")[![gubesch](https://avatars.githubusercontent.com/u/16289522?v=4)](https://github.com/gubesch "gubesch (1 commits)")[![jos0405](https://avatars.githubusercontent.com/u/4246909?v=4)](https://github.com/jos0405 "jos0405 (1 commits)")[![abadb](https://avatars.githubusercontent.com/u/655278?v=4)](https://github.com/abadb "abadb (1 commits)")[![mabumusa1](https://avatars.githubusercontent.com/u/12627658?v=4)](https://github.com/mabumusa1 "mabumusa1 (1 commits)")[![pcottrell](https://avatars.githubusercontent.com/u/1524196?v=4)](https://github.com/pcottrell "pcottrell (1 commits)")[![pgbrandao](https://avatars.githubusercontent.com/u/732094?v=4)](https://github.com/pgbrandao "pgbrandao (1 commits)") --- Tags pluginMauticintegration ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/etailors-mautic-amazon-ses/health.svg) ``` [![Health](https://phpackages.com/badges/etailors-mautic-amazon-ses/health.svg)](https://phpackages.com/packages/etailors-mautic-amazon-ses) ``` ### Alternatives [pressbooks/pressbooks Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS. 45444.2k1](/packages/pressbooks-pressbooks)[helsingborg-stad/municipio A bootstrap theme for creating municipality sites. 4028.5k10](/packages/helsingborg-stad-municipio)[altis/core Core module for Altis 19228.0k3](/packages/altis-core)[mautic/grapes-js-builder-bundle GrapesJS Builder with MJML support for Mautic 5691.8k13](/packages/mautic-grapes-js-builder-bundle)[pabloveintimilla/mautic-amazon-ses Mautic 5 plugin that provides Amazon SES as an email transport and callback to process bounces 452.4k](/packages/pabloveintimilla-mautic-amazon-ses)[firemultimedia/mautic-multi-captcha-bundle This plugin brings Google's reCAPTCHA, hCaptcha, and Cloudflare Turnstile integration to mautic. 141.3k](/packages/firemultimedia-mautic-multi-captcha-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)