PHPackages                             bentonow/bento-statamic-sdk - 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 &amp; Notifications](/categories/mail)
4. /
5. bentonow/bento-statamic-sdk

ActiveStatamic-addon[Mail &amp; Notifications](/categories/mail)

bentonow/bento-statamic-sdk
===========================

Bento addon for Statamic, enabling you to easily integrate Bento with your Statamic site

1.0.1(1y ago)1131MITJavaScript

Since Dec 13Pushed 1y ago1 watchersCompare

[ Source](https://github.com/bentonow/bento-statamic-sdk)[ Packagist](https://packagist.org/packages/bentonow/bento-statamic-sdk)[ Docs](https://github.com/bentonow/bento-statamic-sdk)[ RSS](/packages/bentonow-bento-statamic-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

Bento Statamic Addon
====================

[](#bento-statamic-addon)

[![](https://camo.githubusercontent.com/ccd52ecdfaa83795016c4a0a4e4a63a9c2d1d786d3e6f379497421d5ce8be325/68747470733a2f2f6170702e62656e746f6e6f772e636f6d2f6272616e642f6c6f676f616e696d2e676966)](https://camo.githubusercontent.com/ccd52ecdfaa83795016c4a0a4e4a63a9c2d1d786d3e6f379497421d5ce8be325/68747470733a2f2f6170702e62656e746f6e6f772e636f6d2f6272616e642f6c6f676f616e696d2e676966)

Tip

Need help? Join our [Discord](https://discord.gg/ssXXFRmt5F) or email  for personalized support.

The Bento Statamic Addon makes it quick and easy to send emails and track events in your Statamic applications. We provide powerful and customizable APIs that can be used out-of-the-box to manage subscribers, track events, and send transactional emails through your Statamic Control Panel.

Get started with our [📚 integration guides](https://docs.bentonow.com), or [📘 browse the SDK reference](https://docs.bentonow.com/subscribers).

Features
--------

[](#features)

- **Statamic Control Panel Integration**: Configure Bento directly from your Statamic CP
- **Laravel Mail Integration**: Seamlessly integrate with Laravel's mail system to send transactional emails via Bento
- **Event Tracking**: Create and manage custom events directly from the CP
- **Form Integration**: Associate Bento events with Statamic forms for automated tracking
- **Subscriber Management**: Import and manage subscribers directly from your Statamic site
- **Author Management**: Easily configure email senders through the CP interface
- **Test Email Functionality**: Send test emails to verify your configuration
- **Frontend Tracking**: Optional automatic injection of Bento's tracking script
- **User Sync**: Automatic subscriber creation when new users register

Requirements
------------

[](#requirements)

- PHP 8.0+
- Statamic 5.0+
- Laravel 10.0+
- Bento API Keys

Installation
------------

[](#installation)

1. Install the package via Composer:

```
composer require bentonow/bento-statamic-sdk
```

2. Publish the configuration file and assets:

```
php artisan vendor:publish --tag=bento-config
php artisan vendor:publish --tag=bento-statamic-assets

# (optional) if you wish to use a list of prebuilt bento events
php artisan vendor:publish --tag=bento-statamic-seeders
php artisan db:seed --class="Database\\Seeders\\Bento\\BentoFormEventsSeeder"

```

Configuration
-------------

[](#configuration)

1. Access the Bento configuration page in your Statamic Control Panel under Tools &gt; Bento
2. Enter your Bento credentials:

    - Site UUID
    - Publishable Key
    - Secret Key

    You can find these at [app.bentonow.com/account/teams](https://app.bentonow.com/account/teams)
3. Configure your email settings:

    - Select an author from your Bento account
    - Send a test email to verify your configuration
4. Alternatively, you can configure Bento through your `.env` file:

```
BENTO_ENABLED=true
BENTO_SITE_UUID="bento-site-uuid"
BENTO_PUBLISHABLE_KEY="bento-publishable-key"
BENTO_SECRET_KEY="bento-secret-key"
MAIL_MAILER="bento"
MAIL_FROM_ADDRESS="your-author@email.com"
```

Advanced Features
-----------------

[](#advanced-features)

### User Registration Tracking

[](#user-registration-tracking)

Control automatic user registration tracking in Bento:

- Enable/disable automatic subscriber creation when new users register
- Automatically splits full names into first and last names
- Syncs email and basic user information
- Configure through Advanced Settings in the CP

### User Synchronization Tags

[](#user-synchronization-tags)

When automatic user synchronization is enabled, you can configure default tags that will be automatically applied to new users when they are synchronized with Bento:

- Choose from your existing Bento tags in the Advanced Settings
- Add multiple tags that will be applied to all new users
- Tags are stored consistently whether using database or file-based storage
- Easily manage tags through the Control Panel interface
- Remove tags with a single click
- Changes take effect immediately for new user registrations

#### Configuration Steps:

[](#configuration-steps)

1. Navigate to Tools &gt; Bento &gt; Advanced Settings
2. Enable "Automatic User Sync"
3. Under the sync settings, use the tag selector to add default tags
4. Selected tags will automatically be applied to all new user registrations

#### Example Usage:

[](#example-usage)

If you've selected tags like "new-user" and "needs-onboarding", when a new user registers:

- A subscriber is created in Bento
- The user's name is split into first and last name
- Email and basic user information is synced
- Both "new-user" and "needs-onboarding" tags are automatically applied

This feature allows you to automatically segment new users without any additional configuration.

### Frontend Tracking Script

[](#frontend-tracking-script)

Manage Bento's JavaScript tracking integration:

- Toggle automatic injection of Bento's tracking script
- Tracks visitor behavior and custom events
- Automatically adds tracking code to all frontend pages
- No manual code insertion required

### Custom Events Management

[](#custom-events-management)

Create and manage custom events for Bento automation:

- Define custom event names through the CP interface
- Use events in Bento's advanced flows and email automations
- Track events across your Statamic site
- Manage events with an intuitive UI

### Form Event Integration

[](#form-event-integration)

Connect Statamic forms with Bento events:

- Associate any Statamic form with a Bento event
- Automatically triggers Bento events on form submission
- Sends form data as event properties
- Perfect for triggering automated workflows
- Configure through the Form Events Manager in Advanced Settings

Example form event workflow:

1. Create a custom event in the CP (e.g., "Newsletter Signup")
2. Associate the event with a Statamic form
3. When the form is submitted:
    - Event is automatically triggered in Bento
    - Form data is sent as event properties
    - Triggers any associated Bento automations

Automatic Features
------------------

[](#automatic-features)

### User Registration Tracking

[](#user-registration-tracking-1)

The addon automatically tracks new user registrations in Bento:

- Creates a subscriber when a new user registers
- Splits full names into first and last names
- Syncs email and basic user information

### Email Integration

[](#email-integration)

Once configured, the addon:

- Handles transactional emails through Bento
- Uses your configured Bento authors as email senders

Things to Know
--------------

[](#things-to-know)

1. **Email Limitations**:

    - Bento does not support email attachments
    - No-reply sender addresses are not supported
2. **Rate Limits**:

    - The Bento Transactional Email API is designed for low-volume emails
    - Use for password resets, form notifications, etc.
    - Not suitable for newsletter or bulk email sending
3. **Author Configuration**:

    - You must use an authorized Bento author as your sender address
    - Authors can be configured through the CP interface
4. **Environment Handling**:

    - Configuration changes update your `.env` file
    - Cache is automatically cleared after configuration updates
    - Runtime configuration is updated immediately

Contributing
------------

[](#contributing)

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run the tests
5. Submit a pull request

For major changes, please open an issue first to discuss what you would like to change.

License
-------

[](#license)

The Bento Statamic Addon is open-sourced software licensed under the [MIT license](LICENSE.md).

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance42

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 82.1% 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

Unknown

Total

1

Last Release

512d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2c3e74a41bec04bc53d5125b1e9f3f9a7978ec548c6f4405cbe7fe870d38f334?d=identicon)[bentonow](/maintainers/bentonow)

---

Top Contributors

[![ziptied](https://avatars.githubusercontent.com/u/379362?v=4)](https://github.com/ziptied "ziptied (23 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (3 commits)")[![jessehanley](https://avatars.githubusercontent.com/u/6285267?v=4)](https://github.com/jessehanley "jessehanley (2 commits)")

---

Tags

emailemail marketingtransactionalnewsletterstatamicbentobentonowstatamic-pluginstatamic-cms

### Embed Badge

![Health badge](/badges/bentonow-bento-statamic-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/bentonow-bento-statamic-sdk/health.svg)](https://phpackages.com/packages/bentonow-bento-statamic-sdk)
```

###  Alternatives

[mageplaza/module-smtp

SMTP Extension for Magento 2 helps the owner of store simply install SMTP (Simple Mail Transfer Protocol) server which transmits the messages into codes or numbers

3015.9M8](/packages/mageplaza-module-smtp)[bentonow/bento-laravel-sdk

Laravel SDK for Bento

2338.5k1](/packages/bentonow-bento-laravel-sdk)[slot/mandrill-bundle

Symfony Mandrill Bundle

671.5M1](/packages/slot-mandrill-bundle)[mailersend/mailersend

MailerSend PHP SDK

801.0M7](/packages/mailersend-mailersend)[mailersend/laravel-driver

MailerSend Laravel Driver

87732.8k4](/packages/mailersend-laravel-driver)[hocza/sendy

Sendy API implementation for Laravel

71195.5k](/packages/hocza-sendy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
