PHPackages                             ideneal/emailoctopus - 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. ideneal/emailoctopus

ActiveLibrary[Mail & Notifications](/categories/mail)

ideneal/emailoctopus
====================

EmailOctopus Service Client Library

1.2.0(2y ago)35.9k4[1 PRs](https://github.com/Ideneal/EmailOctopus/pulls)MITPHPPHP >=7.4CI failing

Since Jul 6Pushed 2y ago4 watchersCompare

[ Source](https://github.com/Ideneal/EmailOctopus)[ Packagist](https://packagist.org/packages/ideneal/emailoctopus)[ RSS](/packages/ideneal-emailoctopus/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (6)Used By (0)

EmailOctopus
============

[](#emailoctopus)

[![Packagist](https://camo.githubusercontent.com/5531855c7effdcbf0f68e1cd25344ba6d8ea076ed597cbf46e3d0b9783b6965d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6964656e65616c2f656d61696c6f63746f7075732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ideneal/emailoctopus)[![GitHub license](https://camo.githubusercontent.com/942e017bf0672002dd32a857c95d66f28c5900ab541838c6c664442516309c8a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](https://raw.githubusercontent.com/Ideneal/EmailOctopus/master/LICENSE)[![Travis branch](https://camo.githubusercontent.com/052120e4f2adfddaf0ad0ed449e45302f5591c48141a51b7fad5cb33fbbf5265/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f4964656e65616c2f456d61696c4f63746f7075732f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/Ideneal/EmailOctopus)[![Codacy branch](https://camo.githubusercontent.com/91d17f64696863e014f17fcfb70f4a5f91b655c13e1ddc157d96cae38020db6a/68747470733a2f2f696d672e736869656c64732e696f2f636f646163792f67726164652f61353930346430656362626634303036393166346633616330336533363439652f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://www.codacy.com/app/ideneal-ztl/EmailOctopus)

A PHP wrapper for [EmailOctopus](https://emailoctopus.com/) email marketing service.

For more information on how to set up your account, read the [API docs](http://emailoctopus.com/api-documentation).

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

[](#installation)

To add the library in your project just type the following:

```
composer require ideneal/emailoctopus
```

Usage
-----

[](#usage)

First you need to retrieve the API key as explained in [API docs](http://emailoctopus.com/api-documentation). After that you could initialize the wrapper by adding the following code:

```
use Ideneal\EmailOctopus\EmailOctopus;

$emailOctopus = new EmailOctopus('YOUR-API-KEY');
```

Now you can perform the CRUD operations the API provides using the `$emailOctopus` instance.

### Create new list

[](#create-new-list)

```
use Ideneal\EmailOctopus\Entity\MailingList;

$list = new MailingList();
$list->setName('My cool list');

$emailOctopus->createMailingList($list);
```

### Add a contact to the previous list

[](#add-a-contact-to-the-previous-list)

```
use Ideneal\EmailOctopus\Entity\Contact;

$contact = new Contact();
$contact
    ->setEmail('john.doe@mail.com')
    ->setFirstName('John')
    ->setLastName('Doe')
;

$emailOctopus->createContact($contact, $list);
```

### Retrieve all contacts from the previous list

[](#retrieve-all-contacts-from-the-previous-list)

```
$emailOctopus->getContactsByMailingList($list);
```

### Remove contact from the previous list

[](#remove-contact-from-the-previous-list)

```
$contact = $emailOctopus->getContactByMailingList('CONTACT-ID', $list);
$emailOctopus->deleteContact($contact, $list);
```

License
-------

[](#license)

The repository is available as open source under the terms of the [MIT License](./LICENSE).

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 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

Every ~262 days

Total

5

Last Release

1091d ago

PHP version history (2 changes)1.0.0PHP >=7.1.3

1.2.0PHP >=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/4932b6ca6ef102099284dc463673b659b109f1a50bfca5f0efd2c826529e0991?d=identicon)[Ideneal](/maintainers/Ideneal)

---

Top Contributors

[![Ideneal](https://avatars.githubusercontent.com/u/183482?v=4)](https://github.com/Ideneal "Ideneal (23 commits)")[![ddpkts](https://avatars.githubusercontent.com/u/2785503?v=4)](https://github.com/ddpkts "ddpkts (3 commits)")[![bfintal](https://avatars.githubusercontent.com/u/1033611?v=4)](https://github.com/bfintal "bfintal (1 commits)")[![eccore](https://avatars.githubusercontent.com/u/3885091?v=4)](https://github.com/eccore "eccore (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ideneal-emailoctopus/health.svg)

```
[![Health](https://phpackages.com/badges/ideneal-emailoctopus/health.svg)](https://phpackages.com/packages/ideneal-emailoctopus)
```

###  Alternatives

[laravel-notification-channels/telegram

Telegram Notifications Channel for Laravel

1.1k3.4M35](/packages/laravel-notification-channels-telegram)[s-ichikawa/laravel-sendgrid-driver

This library adds a 'sendgrid' mail driver to Laravel.

4139.3M1](/packages/s-ichikawa-laravel-sendgrid-driver)[laravel-notification-channels/microsoft-teams

A Laravel Notification Channel for Microsoft Teams

1603.0M7](/packages/laravel-notification-channels-microsoft-teams)[laravel-notification-channels/discord

Laravel notification driver for Discord.

2371.3M11](/packages/laravel-notification-channels-discord)[guanguans/notify

Push notification SDK(AnPush、Bark、Chanify、DingTalk、Discord、Gitter、GoogleChat、IGot、Lark、Mattermost、MicrosoftTeams、NowPush、Ntfy、Push、Pushback、PushBullet、PushDeer、PushMe、Pushover、PushPlus、QQ、RocketChat、ServerChan、ShowdocPush、SimplePush、Slack、Telegram、WeWork、WPush、XiZhi、YiFengChuanHua、ZohoCliq、ZohoCliqWebHook、Zulip).

682104.9k7](/packages/guanguans-notify)[tzsk/sms

A robust and unified SMS gateway integration package for Laravel, supporting multiple providers.

320244.3k6](/packages/tzsk-sms)

PHPackages © 2026

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