# Amazon Simple Notification Service (AWS SNS) notification channel for Laravel

Latest Version on Packagist (opens new window) Software License (opens new window) Build Status (opens new window) StyleCI (opens new window) Quality Score (opens new window) Code Coverage (opens new window) Total Downloads (opens new window)

This package makes it easy to send notifications using AWS SNS (opens new window) with Laravel framework. Since Laravel already ships with SES email support, this package focuses on sending only SMS notifications for now. More advanced features like support for topics could be added in the future.

# Contents

# Installation

You can install the package via composer:

composer require laravel-notification-channels/aws-sns --update-with-dependencies

# Setting up the AWS SNS service

Add your AWS key ID, secret and default region to your config/services.php:


return [

    // ...

    'sns' => [
        'key' => env('AWS_ACCESS_KEY_ID'),
        'secret' => env('AWS_SECRET_ACCESS_KEY'),
        'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),


# Usage

Now you can use the channel in your via() method inside the notification:


use NotificationChannels\AwsSns\SnsChannel;
use NotificationChannels\AwsSns\SnsMessage;
use Illuminate\Notifications\Notification;

class AccountApproved extends Notification
    public function via($notifiable)
        return [SnsChannel::class];

    public function toSns($notifiable)
        // You can just return a plain string:
        return "Your {$notifiable->service} account was approved!";
        // OR explicitly return a SnsMessage object passing the message body:
        return new SnsMessage("Your {$notifiable->service} account was approved!");
        // OR return a SnsMessage passing the arguments via `create()` or `__construct()`:
        return SnsMessage::create([
            'body' => "Your {$notifiable->service} account was approved!",
            'transactional' => true,
            'sender' => 'MyBusiness',

        // OR create the object with or without arguments and then use the fluent API:
        return SnsMessage::create()
            ->body("Your {$notifiable->service} account was approved!")

In order to let your Notification know which phone are you sending to, the channel will look for the phone, phone_number or full_phone attribute of the Notifiable model. If you want to override this behaviour, add the routeNotificationForSns method to your Notifiable model.


use Illuminate\Notifications\Notifiable;

class SomeModel {
    use Notifiable;

    public function routeNotificationForSns($notification)
        return '+1234567890';

# Available SnsMessage methods

  • create([]): Accepts an array of key-values where the keys corresponds to the methods below and the values are passed as parameters;
  • body(''): Accepts a string value for the notification body. Messages with more than 140 characters will be split into multiple messages by SNS without breaking any words;
  • promotional(bool): Sets the delivery type as promotional (default). Optimizes the delivery for lower costs;
  • transactional(bool): Sets the delivery type as transactional. Optimizes the delivery to achieve the highest reliability (it also costs more);
  • sender(string): Up to 11 characters with no spaces, that is displayed as the sender on the receiving device. Support varies by country (opens new window);
  • originationNumber(string): A numeric string that identifies an SMS message sender's phone number. Support may not be available in your country, see the AWS SNS Origination number docs (opens new window).

More information about the SMS Attributes can be found on the AWS SNS Docs (opens new window). It's important to know that the attributes set on the message will override the default ones configured in your AWS account.

# Changelog

Please see CHANGELOG (opens new window) for more information what has changed recently.

# Testing

$ composer test

# Security

If you discover any security related issues, please email claudson@outlook.com instead of using the issue tracker.

# Contributing

Please see CONTRIBUTING (opens new window) for details.

# Credits

# License

The MIT License (MIT). Please see License File (opens new window) for more information.