NotifyMe Laravel SDK

Official Laravel client for NotifyMe — send events from your app and deliver them as iOS push notifications.

Packagist: notifyme/laravel
GitHub: vaporinua-vg/notifyme-laravel

Requirements

• PHP 8.2+
• Laravel 11 / 12 / 13

Install

composer require notifyme/laravel
php artisan vendor:publish --tag=notifyme-config

Configure

NOTIFYME_BASE_URL=https://test.upfine.app
NOTIFYME_API_KEY=nm_xxxxxxxx
NOTIFYME_API_SECRET=nms_xxxxxxxx

Get both values in the NotifyMe dashboard → Project. The secret is shown only once.

Usage

use NotifyMe\Laravel\Facades\NotifyMe;

NotifyMe::event('order.created')
    ->title('New order')
    ->message('Order #1234 received')
    ->priority('high')
    ->data([
        'order_id' => ['label' => 'Order number', 'value' => 1234],
        'amount' => ['label' => 'Total', 'value' => '59€'],
    ])
    ->send();

Or with a plain array:

NotifyMe::send([
    'event' => 'order.created',
    'title' => 'New order',
    'message' => 'Order #1234 received',
    'priority' => 'high',
    'data' => [
        'order_id' => 1234,
    ],
]);

Response:

['success' => true, 'event_id' => '...']

On HTTP errors the client throws NotifyMe\Laravel\Exceptions\NotifyMeException.

Security

• Never put NOTIFYME_API_SECRET in the frontend or git.
• Use server-side code only (jobs, listeners, controllers).
• Rotate credentials in the dashboard if leaked.

Auth headers (what the package sends)

Authorization: Bearer <api_key>
X-NotifyMe-Secret: <api_secret>
Content-Type: application/json

License

MIT