alfredo-ramos/mailrelay-api-client

Mailrelay API Client

0.2.1 2025-07-01 03:26 UTC

Requires

• php: ^7.2.5 || ^8.0.0
• guzzlehttp/guzzle: ^7.2.0

Requires (Dev)

• phpunit/phpunit: ^8.5.42 || ^9.6.23 || ^10.5.47 || ^11.5.25 || ^12.2.25

GPL-3.0-or-later

• Alfredo Ramos

• api
• client
• email
• mailrelay

README

About

A Mailrelay API client.

⚠️ While all API endpoints have been implemented, it's still under development, so it might have some bugs.

Requirements

• PHP 8.1.0 or greater

Installation

Open your composer.json file and add the package in the require object:

"alfredo-ramos/mailrelay-api-client": "^0.3.0"

Then run composer update on your terminal.

Usage

The constructor takes an array with the API data needed to connect with your Mailrelay account.

require __DIR__ . '/vendor/autoload.php';

$mailrelay = new AlfredoRamos\Mailrelay\Client([
	'api_account' => 'mailrelay_account',
	'api_token' => 'mailrelay_api_token'
]);

Key	Type	Required	Description
api_account	string	Yes	The account name you use to login into Mailrelay.
api_token	string	Yes	The Mailrelay API token generated from https://{ACCOUNT}.ipzmarketing.com/admin/api_keys.

You can access each endpoint using the AlfredoRamos\Mailrelay\Client::api() method.

// Create or update a subscriber
$mailrelay->api('subscribers')->sync([
	'status' => 'active',
	'email' => '[e-mail]',
	'group_ids' => [1]
]);

// Get account package info
$mailrelay->api('package')->info();

To get the number of total pages and results per page for list() methods:

$result = $this->client->withOptions(['full_response' => true])->api('subscribers')->list([
	'page' => 1, 'per_page' => 10
]);
$subscribers = $result->toArray();
$total = $result->totalPages();
$perPage = $result->perPage();

For more detailed information about Mailrelay API endpoints, please refer to the official API documentation.