rapidmail API v3 client

1.1.4 2023-07-18 12:38 UTC

This package is auto-updated.

Last update: 2024-04-30 00:31:11 UTC


API client written in PHP providing access to the current version of the rapidmail API.

CI Status Latest Stable Version

Installation With Composer

Preferred installation method is to use the Composer dependency manager.

composer require rapidmail/rapidmail-apiv3-client-php

Getting started

Create a new API client instance and provide your APIv3 credentials:

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

use Rapidmail\ApiClient\Client;

$client = new Client('api_username_hash', 'api_password_hash');

After that you can access various services encapsulated within the client:

$mailingService = $client->mailings();

// Iterate all mailings 

foreach($mailingService->query() as $mailing) {


Retrieve mailings

Get a list of your mailings with some filters applied:

// Filter for sent mailings newer than a given date 

        'created_since' => '2019-09-01 10:22:00',
        'status' => 'sent'

Retrieve recipient lists

$listService = $client->recipientlists();

foreach ($listService->query() as $list) {

Retrieve recipients

$recipientsService = $client->recipients();

$collection = $recipientsService->query(
        'recipientlist_id' => 123456789 // Recipientlist ID MUST be provided

foreach ($collection as $recipient) {

Create a new recipient

$recipientsService = $client->recipients();

        // Dataset: Represents the recipient dataset you're creating
            'recipientlist_id' => 123456789, // Required
            'email' => 'john@example.net', // Required
            'firstname' => 'John',
            'lastname' => 'Doe',
            'gender' => 'male'
        // Flags: Configures system behavior, like sending activationmails
            'send_activationmail' => 'yes'

Error handling

Always keep in mind to handle errors properly and catch exceptions that might occur:

use \Rapidmail\ApiClient\Exception\ApiClientException;

try {
    $mailingService->query(['status' => 'unknown']);
} catch (ApiClientException $e) {
    // Catch API client exceptions
    echo "Exception raised: " . $e->getMessage();


More information about using the API client can be found in the following subsections:

Known issues

  • Exceptions on 201 HTTP-Response-Code (used when a dataset was successfully created) are generated when using PHP Versions 7.4.5 and 8.1.2. If you're having issues with these versions, please try updating to a later version of PHP.

Also refer to the API documentation for a complete list of the available endpoints and their parameters.


rapidmail APIv3 client is licensed under the terms of the BSD 2-clause license.


Contact: www.rapidmail.de - support@rapidmail.de - +49 761 - 216 08 720