AWS End User Messaging SMS plugin for Mautic 7: native SMS transport with IAM and consent controls

beto2l · August 28, 2026, 10:58pm

Hi Mautic community,

I am sharing an open-source plugin that adds AWS End User Messaging SMS as a native SMS transport for Mautic 7.

GitHub:

Installation guide:

docs/INSTALLATION.md

d501cfd9a

# Installation and operation guide

This guide covers installation, AWS prerequisites, Mautic configuration, canary testing, and sending a text SMS to an approved segment without n8n.

The screenshots use example values. Replace them with the values from your own AWS account and Mautic instance. Do not publish screenshots containing account IDs, ARNs, phone numbers, contact records, access keys, or private URLs.

## 1. Prerequisites

Before installing the plugin, prepare:

- Mautic 7.x with PHP 8.2 or newer.
- The AWS SDK for PHP available through the Mautic Composer installation.
- An AWS End User Messaging SMS origination identity approved for your country and message type.
- An AWS configuration set, for example `example-sms-config`.
- An EC2 instance profile or another AWS default credential provider attached to the Mautic host.
- An IAM policy that grants `sms-voice:SendTextMessage` only to the approved SMS resources.
- A Mautic phone field that contains values that can be normalized to E.164.
- A Mautic consent field and an approved segment containing only contacts who opted in to SMS.

The plugin uses the AWS role attached to the Mautic server. Do not paste AWS access keys into Mautic or commit them to this repository.

This file has been truncated. show original

Current features:

Native SMS transport inside Mautic.
Uses the IAM role attached to the Mautic server.
AWS access keys are not stored in Mautic.
Canary mode for testing with one approved phone number.
Production mode restricted to approved audiences.
SMS consent validation.
Approved Mautic segment validation.
E.164 phone number normalization.
Configurable daily and per-minute delivery limits.
Message length and emoji safeguards.
Works with Mautic’s native SMS workflow without requiring n8n.

Requirements:

Mautic 7.x.
PHP 8.2 or newer.
AWS End User Messaging SMS.
An approved AWS origination identity.
An IAM role with the required SMS permissions.

The current release focuses on text SMS. MMS, RCS, inbound replies, and delivery-event webhooks are not included yet.

I am looking for feedback from Mautic users and developers, especially around compatibility, installation, delivery monitoring, and additional safeguards.

Issues and support:

Please do not include credentials, AWS account IDs, ARNs, phone numbers, or contact records in issue reports.

Topic		Replies	Views
Aws sns for sms and with cognito login MFA General Discussion	0	306	June 29, 2021
Sending SMS Through Mautic & AWS General Discussion community	0	344	October 27, 2021
Amazon SES Plugin for Mautic 6+ — Bounce, Complaint & Full Event Tracking via SNS 3rd Party Addons community , development	7	147	April 13, 2026
Using Amazon SNS for mobile push notifications Product Support	3	649	September 14, 2022
Hiring to Build Custom Plugin for SMS Marketing Commercial	8	261	July 18, 2025

AWS End User Messaging SMS plugin for Mautic 7: native SMS transport with IAM and consent controls

Related topics