mailrify/mailrify-php

Official Mailrify PHP SDK

v1.1.0 2026-02-16 13:06 UTC

Requires

• php: >=8.1
• ext-json: *
• guzzlehttp/guzzle: ^7.0

Requires (Dev)

• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^10.0
• squizlabs/php_codesniffer: ^3.11

MIT

README

Official Mailrify PHP SDK.

Requirements

• PHP 8.1+

Installation

composer require mailrify/mailrify-php

Initialization

<?php

declare(strict_types=1);

use Mailrify\Mailrify;

$client = new Mailrify('sk_your_api_key');

// Optional config
$client = new Mailrify('sk_your_api_key', [
    'baseUrl' => 'https://api.mailrify.com',
    'timeout' => 30000,
]);

Emails

<?php

// Send email
$sendResult = $client->emails->send([
    'to' => '[e-mail]',
    'from' => ['name' => 'My App', 'email' => '[e-mail]'],
    'subject' => 'Welcome!',
    'body' => '<h1>Hello {{name}}</h1>',
    'data' => ['name' => 'John'],
]);

// Verify email
$verification = $client->emails->verify('[e-mail]');
var_dump($verification->valid);
var_dump($verification->isRandomInput);

Events

<?php

use Mailrify\Mailrify;

// Track event (public key only)
$tracker = new Mailrify('pk_your_public_key');
$trackResult = $tracker->events->track([
    'email' => '[e-mail]',
    'event' => 'purchase',
    'data' => ['product' => 'Premium', 'amount' => 99],
]);

// List event names (secret key)
$eventNames = $client->events->listNames();

Contacts

<?php

$contactsPage = $client->contacts->list(['limit' => 50]);

$contact = $client->contacts->create([
    'email' => '[e-mail]',
    'data' => ['firstName' => 'John', 'plan' => 'premium'],
]);

$fetched = $client->contacts->get($contact->id);

$updated = $client->contacts->update($contact->id, [
    'subscribed' => false,
]);

$totalContacts = $client->contacts->count();

$client->contacts->delete($contact->id);

Segments

<?php

$segment = $client->segments->create([
    'name' => 'Premium Users',
    'condition' => [
        'logic' => 'AND',
        'groups' => [
            [
                'filters' => [
                    ['field' => 'data.plan', 'operator' => 'equals', 'value' => 'premium'],
                ],
            ],
        ],
    ],
    'trackMembership' => true,
]);

$segments = $client->segments->list();
$singleSegment = $client->segments->get($segment->id);

$updatedSegment = $client->segments->update($segment->id, [
    'name' => 'Premium Users v2',
]);

$members = $client->segments->listContacts($segment->id, ['page' => 1, 'pageSize' => 20]);

$client->segments->delete($segment->id);

Campaigns

<?php

$campaign = $client->campaigns->create([
    'name' => 'Product Launch',
    'subject' => 'Introducing our new feature!',
    'body' => '<h1>Big news!</h1><p>Check out our latest feature.</p>',
    'from' => '[e-mail]',
    'audienceType' => 'ALL',
]);

$campaignList = $client->campaigns->list(['status' => 'DRAFT']);
$singleCampaign = $client->campaigns->get($campaign->id);

$updatedCampaign = $client->campaigns->update($campaign->id, [
    'subject' => 'Updated subject',
]);

// Immediate send
$client->campaigns->send($campaign->id);

// Scheduled send
$client->campaigns->send($campaign->id, [
    'scheduledFor' => '2026-03-01T10:00:00Z',
]);

// Send test email
$client->campaigns->test($campaign->id, '[e-mail]');

// Get stats
$stats = $client->campaigns->stats($campaign->id);

// Cancel
$client->campaigns->cancel($campaign->id);

Error Handling

<?php

use Mailrify\Exceptions\AuthenticationException;
use Mailrify\Exceptions\NotFoundException;
use Mailrify\Exceptions\RateLimitException;
use Mailrify\Exceptions\ValidationException;

try {
    $client->contacts->get('missing-id');
} catch (AuthenticationException $e) {
    // 401
} catch (ValidationException $e) {
    // 400
} catch (NotFoundException $e) {
    // 404
} catch (RateLimitException $e) {
    // 429
}