renzojohnson/mailgun-api

Lightweight PHP wrapper for Mailgun API. Send emails, validate addresses, manage domains. Zero dependencies beyond ext-curl.

Maintainers

Package info

github.com/renzojohnson/mailgun-api

Homepage

pkg:composer/renzojohnson/mailgun-api

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v0.26.03.16 2026-03-17 02:15 UTC

Requires

Requires (Dev)

MIT c0060d18ed71aa786951a0e56668f62e50796b87

phpemailmailguntransactional-emailemail-apimailgun-api

This package is auto-updated.

Last update: 2026-03-17 02:17:49 UTC

README

Latest Version PHP Version License

Lightweight PHP wrapper for Mailgun API. Send emails, validate addresses, manage domains. Zero dependencies beyond ext-curl.

Author: Renzo Johnson

Requirements

  • PHP 8.4 or higher
  • ext-curl
  • ext-json

Installation

composer require renzojohnson/mailgun-api

Quick Start

use RenzoJohnson\Mailgun\Mailgun;

$mailgun = new Mailgun('key-your-api-key', 'mg.yourdomain.com');

// Send a simple text email
$mailgun->sendText(
    'sender@mg.yourdomain.com',
    'recipient@example.com',
    'Hello from Mailgun',
    'This is the email body.'
);

Send HTML Email

$mailgun->sendHtml(
    'sender@mg.yourdomain.com',
    'recipient@example.com',
    'Welcome!',
    '<h1>Welcome</h1><p>Thanks for signing up.</p>',
    'Welcome! Thanks for signing up.' // optional plain text fallback
);

Advanced Email Builder

use RenzoJohnson\Mailgun\Message\Email;

$email = new Email(
    'sender@mg.yourdomain.com',
    'recipient@example.com',
    'Order Confirmation',
    text: 'Your order has been confirmed.',
    html: '<h1>Order Confirmed</h1>'
);

$email->cc('manager@example.com')
    ->bcc('archive@example.com')
    ->replyTo('support@example.com')
    ->header('X-Campaign', 'welcome-series')
    ->variable('order_id', '12345')
    ->tag('transactional');

$mailgun->send($email);

Domain Info

// Get domain details
$info = $mailgun->getDomainInfo();

// List all domains
$domains = $mailgun->listDomains();

Events & Stats

// Get sending events
$events = $mailgun->getEvents(['event' => 'delivered', 'limit' => 10]);

// Get delivery stats (last 7 days)
$stats = $mailgun->getStats('delivered', 7);

Email Validation

// Validate an email address (requires validation API key)
$result = $mailgun->validateEmail('user@example.com');

Error Handling

use RenzoJohnson\Mailgun\Exception\ApiException;

try {
    $mailgun->sendText('from@mg.example.com', 'to@example.com', 'Test', 'Body');
} catch (ApiException $e) {
    echo $e->getMessage(); // "Mailgun API error (401): Forbidden"
}

Links

License

MIT License. Copyright (c) 2026 Renzo Johnson.