PHPackages                             datalinx/squalomail-php-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. [API Development](/categories/api)
4. /
5. datalinx/squalomail-php-sdk

ActiveLibrary[API Development](/categories/api)

datalinx/squalomail-php-sdk
===========================

PHP SDK for SqualoMail

v1.3.0(3y ago)139[1 PRs](https://github.com/DataLinx/SqualoMail-PHP-SDK/pulls)MITPHPPHP >=7.4

Since Apr 28Pushed 2y ago1 watchersCompare

[ Source](https://github.com/DataLinx/SqualoMail-PHP-SDK)[ Packagist](https://packagist.org/packages/datalinx/squalomail-php-sdk)[ Docs](https://github.com/datalinx/squalomail-php-sdk)[ RSS](/packages/datalinx-squalomail-php-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (2)Versions (9)Used By (0)

PHP SDK for the SqualoMail API
==============================

[](#php-sdk-for-the-squalomail-api)

[![Packagist PHP Version Support](https://camo.githubusercontent.com/19a4d376852cb94cfb6b197e3531298e58582d6c363c2478fe92d8fbf4aa5abd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f646174616c696e782f737175616c6f6d61696c2d7068702d73646b)](https://camo.githubusercontent.com/19a4d376852cb94cfb6b197e3531298e58582d6c363c2478fe92d8fbf4aa5abd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f646174616c696e782f737175616c6f6d61696c2d7068702d73646b)[![Packagist Version](https://camo.githubusercontent.com/a2517b1cc24ba677ceee960461700f5f5c2cb15fc1024b99404ad3a36c90f922/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f646174616c696e782f737175616c6f6d61696c2d7068702d73646b)](https://camo.githubusercontent.com/a2517b1cc24ba677ceee960461700f5f5c2cb15fc1024b99404ad3a36c90f922/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f646174616c696e782f737175616c6f6d61696c2d7068702d73646b)[![Packagist Downloads](https://camo.githubusercontent.com/e0b6512b0107982171fb3e36eaa3f2be5b19a755633db57cf8e5d9c9f61543c4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f646174616c696e782f737175616c6f6d61696c2d7068702d73646b)](https://camo.githubusercontent.com/e0b6512b0107982171fb3e36eaa3f2be5b19a755633db57cf8e5d9c9f61543c4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f646174616c696e782f737175616c6f6d61696c2d7068702d73646b)[![Tests](https://github.com/DataLinx/SqualoMail-PHP-SDK/actions/workflows/tests.yml/badge.svg)](https://github.com/DataLinx/SqualoMail-PHP-SDK/actions/workflows/tests.yml)[![Conventional Commits](https://camo.githubusercontent.com/9f7a75f0e3af8cca0597d218e8708da4791128679178573a9806a514be52d2eb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e76656e74696f6e616c253230436f6d6d6974732d312e302e302d2532334645353139363f6c6f676f3d636f6e76656e74696f6e616c636f6d6d697473266c6f676f436f6c6f723d7768697465)](https://conventionalcommits.org)[![Packagist License](https://camo.githubusercontent.com/105f2785f3d04c90fa219b219da47f4895ee847b7e7b0c3bb366a98364eb67ce/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f646174616c696e782f737175616c6f6d61696c2d7068702d73646b)](https://camo.githubusercontent.com/105f2785f3d04c90fa219b219da47f4895ee847b7e7b0c3bb366a98364eb67ce/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f646174616c696e782f737175616c6f6d61696c2d7068702d73646b)

About
-----

[](#about)

**Disclaimer: This is not an official SDK.**

With this package you can use the SqualoMail API in your PHP project.

See the changelog [here](CHANGELOG.md).

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

[](#requirements)

- PHP >= 7.4
- CURL and JSON PHP extensions
- Ubuntu is tested and supported, but should also work on Windows

Installing
----------

[](#installing)

Download it with composer:

```
composer require datalinx/squalomail-php-sdk
```

Usage
-----

[](#usage)

```
$api = new API('your API key here');

$request = new CreateRecipient($api);
$request->email = 'john@example.com';
$request->name = 'John';
$request->surname = 'Doe';

try {
    $response = $request->send();

    // Subscribed, see the CreateRecipientResponse class for details
    echo $response->getRecipient()->id;
}
catch (Exception $exception) {
    echo 'Oops, something went wrong: '. $exception->getMessage();
}
```

### Requests implementation

[](#requests-implementation)

All API endpoints are specified [here](https://api.squalomail.com/v1/help).
However, only the following are implemented in this package currently.

RequestNotesCreate recipientGet recipientGet recipient's listsSee the `GetRecipientLists` class docblock for explanation.Update recipientYou can provide either the recipient ID or the email. If you provide both, the email address for the matching recipient ID will be updated.Delete recipientYou can delete recipients only by ID, so fetch the ID with a `GetRecipient` request first.Create listDelete listGet listSee the `GetList::send()` method docblock for the response dataGet list recipientsDoes not support paginationGet lists detailsSubscribe by emailThis works only for recipients that are already created. If re-subscribing, also set the "accept" parameter to "true".Unsubscribe by emailThe "accept" attribute on the recipient is updated considering how you configured it in SqualoMail settings (Slovenian: "Po kliku na povezavo za odjavo naj prejemnika odjavi od"). You can also send a boolean here to force a change, but it will be ignored when the setting is set to the third option (Slovenian: "Prejemanja katerihkoli sporočil v prihodnje").Contributing
------------

[](#contributing)

If you have some suggestions how to make this package better, please open an issue or even better, submit a pull request.

Should you want to contribute, please see the development guidelines in the [DataLinx PHP package template](https://github.com/DataLinx/php-package-template).

### Changelog

[](#changelog)

All notable changes to this project are automatically documented in the [CHANGELOG.md](CHANGELOG.md) file using the release workflow, based on the [release-please](https://github.com/googleapis/release-please) GitHub action.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

For all this to work, commit messages must follow the [Conventional commits](https://www.conventionalcommits.org/) specification, which is also enforced by a Git hook.

### Developer documentation

[](#developer-documentation)

- [Official SqualoMail API documentation](https://www.squalomail.com/sl/podpora/sistemski-api/) (in Slovenian and Italian only)
- [Endpoint list](https://api.squalomail.com/v1/help)

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~29 days

Recently: every ~42 days

Total

7

Last Release

1297d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/131700?v=4)[Omer Sabic](/maintainers/SlimDeluxe)[@SlimDeluxe](https://github.com/SlimDeluxe)

---

Top Contributors

[![SlimDeluxe](https://avatars.githubusercontent.com/u/131700?v=4)](https://github.com/SlimDeluxe "SlimDeluxe (38 commits)")

---

Tags

phpapisdkwebserviceSloveniasqualomail

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/datalinx-squalomail-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/datalinx-squalomail-php-sdk/health.svg)](https://phpackages.com/packages/datalinx-squalomail-php-sdk)
```

###  Alternatives

[jstolpe/instagram-graph-api-php-sdk

Instagram Graph API PHP SDK

13998.4k2](/packages/jstolpe-instagram-graph-api-php-sdk)[clever/clever-php

231.6k](/packages/clever-clever-php)

PHPackages © 2026

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