PHP Examples

composer require metigan/metigan-php

<?php

require 'vendor/autoload.php';

use Metigan\MetiganClient;
use Metigan\Exception\ApiException;
use Metigan\Exception\ValidationException;

// Initialize the client
$client = new MetiganClient(getenv('METIGAN_API_KEY'));

// Send email
try {
    $result = $client->email()->sendEmail(
        fromAddress: "Sender <sender@example.com>",
        recipients: ["recipient@example.com"],
        subject: "Hello!",
        content: "<h1>Hello!</h1><p>Thank you for signing up.</p>"
    );

    if ($result['success'] ?? false) {
        echo "Email sent successfully!
";
        // IMPORTANT: API returns fields in camelCase (emailsRemaining), not snake_case
        echo "Emails remaining: " . ($result['emailsRemaining'] ?? 'N/A') . "
";
    }
} catch (ValidationException $e) {
    echo "Validation Error: " . $e->getMessage() . "
";
} catch (ApiException $e) {
    echo "API Error: " . $e->getStatusCode() . " - " . $e->getMessage() . "
";
}

$result = $client->email()->sendEmail(
    fromAddress: "sender@example.com",
    recipients: ["recipient@example.com"],
    subject: "Email Subject",
    content: "<h1>HTML Content</h1><p>This is the email body.</p>"
);

if ($result['success']) {
    echo "Email sent successfully!
";
    echo "Emails remaining: " . $result['emailsRemaining'] . "
";
}

$result = $client->email()->sendEmail(
    fromAddress: "company@email.com",
    recipients: ["main@email.com"],
    subject: "Meeting",
    content: "Email content",
    cc: ["copy@email.com"],
    bcc: ["hidden-copy@email.com"],
    replyTo: "reply-here@email.com"
);

$fileData = file_get_contents("document.pdf");

$result = $client->email()->sendEmail(
    fromAddress: "company@email.com",
    recipients: ["customer@email.com"],
    subject: "Important Document",
    content: "Please find the document attached.",
    attachments: [
        [
            'content' => $fileData,
            'filename' => 'document.pdf',
            'contentType' => 'application/pdf'
        ]
    ]
);

$result = $client->email()->sendEmailWithTemplate(
    templateId: "template-123",
    variables: [
        'name' => 'John Doe',
        'company' => 'Acme Inc'
    ],
    fromAddress: "sender@example.com",
    recipients: ["recipient@example.com"],
    replyTo: "reply@example.com"
);

$contact = $client->contacts()->create(
    email: "new@email.com",
    audienceId: "audience-123",
    firstName: "Jane",
    lastName: "Doe",
    phone: "+1234567890",
    tags: ["customer", "newsletter"]
);

$contact = $client->contacts()->get("contact-456");
echo $contact['email'] . ": " . $contact['firstName'];

$result = $client->contacts()->list(
    audienceId: "audience-123",
    status: "subscribed",
    page: 1,
    limit: 50
);

foreach ($result['contacts'] ?? [] as $contact) {
    echo $contact['email'] . ": " . ($contact['firstName'] ?? 'N/A') . "
";
}

$updated = $client->contacts()->update(
    contactId: "contact-456",
    firstName: "Jane Marie",
    tags: ["customer", "vip"]
);

// Subscribe
$client->contacts()->subscribe("contact-456");

// Unsubscribe
$client->contacts()->unsubscribe("contact-456");

$audience = $client->audiences()->create(
    name: "Main Newsletter",
    description: "Main subscriber list"
);

$result = $client->audiences()->list(page: 1, limit: 10);

foreach ($result['audiences'] ?? [] as $audience) {
    echo $audience['name'] . ": " . ($audience['count'] ?? 0) . " contacts
";
}

$stats = $client->audiences()->getStats("audience-123");
echo "Total: " . ($stats['total'] ?? 0) . "
";
echo "Subscribed: " . ($stats['subscribed'] ?? 0) . "
";

use Metigan\Exception\ApiException;
use Metigan\Exception\ValidationException;

try {
    $result = $client->email()->sendEmail(/* ... */);
} catch (ValidationException $e) {
    echo "Validation Error: " . $e->getMessage() . "
";
    if ($e->getField()) {
        echo "Field: " . $e->getField() . "
";
    }
} catch (ApiException $e) {
    echo "API Error: " . $e->getStatusCode() . " - " . $e->getMessage() . "
";
} catch (Exception $e) {
    echo "Unknown error: " . $e->getMessage() . "
";
}

$client = new MetiganClient(
    apiKey: "your-api-key",
    timeout: 30,        // Optional, defaults to 30 seconds
    retryCount: 3,      // Optional, defaults to 3
    retryDelay: 2,      // Optional, defaults to 2 seconds
    debug: false        // Optional, defaults to false
);