alfredo-ramos/mailrelay-api-client

Mailrelay API Client

0.2.1 2025-07-01 03:26 UTC

This package is auto-updated.

Last update: 2025-07-01 04:47:09 UTC


README

About

A Mailrelay API client.

Build Status Latest Stable Version Code Quality License

⚠️ 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' => 'user@example.org',
	'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.