PHP code example of sendpigeon / sdk

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

sendpigeon / sdk example snippets

use SendPigeon\SendPigeon;

$client = new SendPigeon('sk_live_xxx');

$response = $client->send(
    to: '[email protected]',
    subject: 'Hello',
    html: '<p>Welcome to SendPigeon!</p>'
);

echo "Email sent: " . $response->id;

$client = new SendPigeon(
    apiKey: 'sk_live_xxx',
    baseUrl: 'https://api.sendpigeon.dev',  // Custom base URL
    timeout: 30,                             // Request timeout in seconds
    maxRetries: 2,                           // Retry attempts (max 5)
);

$response = $client->send(
    to: '[email protected]',
    from: '[email protected]',
    subject: 'Welcome!',
    html: '<h1>Welcome</h1><p>Thanks for signing up!</p>',
    text: 'Welcome! Thanks for signing up.',
);

$response = $client->send(
    to: ['[email protected]', '[email protected]'],
    subject: 'Team Update',
    html: '<p>Important update for the team.</p>',
    cc: '[email protected]',
    bcc: ['[email protected]'],
);

$response = $client->send(
    to: '[email protected]',
    templateId: 'tmpl_xxx',
    variables: [
        'name' => 'John',
        'company' => 'Acme Inc',
    ],
);

$response = $client->send(
    to: '[email protected]',
    subject: 'Your invoice',
    html: '<p>Please find your invoice attached.</p>',
    attachments: [
        [
            'filename' => 'invoice.pdf',
            'content' => base64_encode(file_get_contents('invoice.pdf')),
        ],
    ],
);

$response = $client->send(
    to: '[email protected]',
    subject: 'Reminder',
    html: '<p>Don\'t forget about tomorrow\'s meeting!</p>',
    scheduledAt: '2024-01-15T10:00:00Z',
);

$response = $client->sendBatch([
    ['to' => '[email protected]', 'subject' => 'Hello', 'html' => '<p>Hi User 1!</p>'],
    ['to' => '[email protected]', 'subject' => 'Hello', 'html' => '<p>Hi User 2!</p>'],
]);

foreach ($response->data as $result) {
    if ($result->status === 'sent') {
        echo "Email {$result->index} sent: {$result->id}\n";
    }
}

use SendPigeon\Types\TrackingOptions;

$response = $client->send(
    to: '[email protected]',
    subject: 'Welcome!',
    html: '<p>Check out our <a href="https://example.com">site</a>!</p>',
    tracking: new TrackingOptions(opens: true, clicks: true),
);

// Response may 

// Get email by ID
$email = $client->emails->get('email_xxx');

// Cancel scheduled email
$cancelled = $client->emails->cancel('email_xxx');

use SendPigeon\Types\Template;

// Create template
$template = $client->templates->create(
    name: 'welcome',
    subject: 'Welcome, {{name}}!',
    html: '<h1>Hello {{name}}</h1><p>Welcome to {{company}}!</p>',
);

// Get template
$template = $client->templates->get('tmpl_xxx');

// List templates
$result = $client->templates->list();

// Update template
$template = $client->templates->update(
    id: 'tmpl_xxx',
    subject: 'Updated subject',
);

// Delete template
$client->templates->delete('tmpl_xxx');

// Add domain
$domain = $client->domains->create('mail.yourdomain.com');

// DNS records are returned for setup
foreach ($domain->dnsRecords as $record) {
    echo "{$record->type} {$record->name} -> {$record->value}\n";
}

// Verify domain
$result = $client->domains->verify('dom_xxx');
if ($result->verified) {
    echo "Domain verified!\n";
}

// List domains
$result = $client->domains->list();

// Delete domain
$client->domains->delete('dom_xxx');

use SendPigeon\Types\ApiKeyMode;
use SendPigeon\Types\ApiKeyPermission;

// Create API key
$key = $client->apiKeys->create(
    name: 'Production',
    mode: ApiKeyMode::Live,
    permission: ApiKeyPermission::FullAccess,
);

// Save $key->key - only returned once!
echo "API Key: " . $key->key;

// List API keys
$result = $client->apiKeys->list();

// Delete API key
$client->apiKeys->delete('key_xxx');

use SendPigeon\Webhooks;

// In your webhook handler
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '';
$timestamp = $_SERVER['HTTP_X_WEBHOOK_TIMESTAMP'] ?? '';

$result = Webhooks::verify(
    payload: $payload,
    signature: $signature,
    timestamp: $timestamp,
    secret: 'whsec_xxx',  // Your webhook secret
    maxAge: 300,          // Max age in seconds
);

if (!$result->valid) {
    http_response_code(401);
    echo $result->error;
    exit;
}

// Handle webhook event
$eventType = $result->payload['type'];
switch ($eventType) {
    case 'email.delivered':
        // Handle delivery
        break;
    case 'email.bounced':
        // Handle bounce
        break;
}

http_response_code(200);

$result = Webhooks::verifyInbound(
    payload: $payload,
    signature: $signature,
    timestamp: $timestamp,
    secret: 'whsec_inbound_xxx',
);

use SendPigeon\Exceptions\SendPigeonException;

try {
    $response = $client->send(
        to: '[email protected]',
        subject: 'Hello',
    );
} catch (SendPigeonException $e) {
    echo "Error: " . $e->getMessage() . "\n";
    echo "Code: " . $e->errorCode . "\n";      // 'api_error', 'network_error', 'timeout_error'
    echo "API Code: " . $e->apiCode . "\n";    // API-specific code like 'validation_error'
    echo "Status: " . $e->status . "\n";       // HTTP status code
    // $e->details: extra fields beyond message/code, e.g. for
    // HOURLY_LIMIT_EXCEEDED / DAILY_LIMIT_EXCEEDED:
    // ['daily_limit' => 5000, 'daily_used' => 5000, 'daily_remaining' => 0, 'retry_after_seconds' => 3600]
}

$response = $client->send(
    to: '[email protected]',
    subject: 'Order confirmation',
    html: '<p>Your order has been confirmed.</p>',
    idempotencyKey: 'order-12345-confirmation',
);

bash
# Terminal 1: Start local server
npx @sendpigeon-sdk/cli dev

# Terminal 2: Run your app with dev mode
SENDPIGEON_DEV=true php app.php