curl -H "Authorization: Bearer mf_key" \
     "https://yourapp.com/api/v1/contacts?page=1&per_page=25&status=active"

curl -X POST https://yourapp.com/api/v1/contacts \
  -H "Authorization: Bearer mf_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john@acme.com",
    "first_name": "John",
    "last_name": "Doe",
    "company": "ACME Corp",
    "source": "crm",
    "list_ids": [1, 3]
  }'

// Call from your website's email signup form
async function subscribe(email, name) {
  const res = await fetch('/api/v1/contacts/subscribe', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer mf_your_api_key',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      email, first_name: name,
      list_id: 1,       // optional: add to specific list
      source: 'website-footer'
    })
  });
  const data = await res.json();
  // { success: true, data: { subscribed: true, email: "..." } }
}

curl -H "Authorization: Bearer mf_key" https://yourapp.com/api/v1/contacts/42

curl -X PUT https://yourapp.com/api/v1/contacts/42 \
  -H "Authorization: Bearer mf_key" \
  -H "Content-Type: application/json" \
  -d '{"company": "New Corp", "status": "active"}'

curl -X DELETE -H "Authorization: Bearer mf_key" https://marketing.bithost.in/api/v1/contacts/42

curl -X DELETE -H "Authorization: Bearer mf_key" https://yourapp.com/api/v1/contacts/42

curl -X POST https://yourapp.com/api/v1/contacts/unsubscribe \
  -H "Authorization: Bearer mf_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'

curl -X POST https://yourapp.com/api/v1/lists \
  -H "Authorization: Bearer mf_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "VIP Customers", "description": "High-value segment"}'

curl -X POST https://yourapp.com/api/v1/contacts/bulk \
  -H "Authorization: Bearer mf_key" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": 1,
    "contacts": [
      {"email": "alice@company.com", "first_name": "Alice", "company": "Acme"},
      {"email": "bob@company.com", "first_name": "Bob", "source": "crm"}
    ]
  }'

curl -X PUT https://yourapp.com/api/v1/contacts/42/tags \
  -H "Authorization: Bearer mf_key" \
  -d '{"tags": ["vip", "enterprise", "demo-attended"]}'

curl -X POST https://yourapp.com/api/v1/suppressions \
  -d '{"email": "optout@example.com", "reason": "manual"}'

curl -X POST https://yourapp.com/api/v1/campaigns/5/send \
  -H "Authorization: Bearer mf_key"

curl -X POST https://yourapp.com/api/v1/inbound \
  -H "Authorization: Bearer mf_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales Inbox",
    "forward_url": "https://yourcrm.com/webhooks/email",
    "auto_create_contact": true,
    "auto_tag": "inbound,hot-lead",
    "list_id": 1
  }'

curl -X POST https://yourapp.com/inbound/receive/abc123token \
  -H "Content-Type: application/json" \
  -H "X-Mailforge-Signature: sha256=..." \
  -d '{
    "from_email": "lead@acmecorp.com",
    "from_name": "Priya Sharma",
    "subject": "Interested in your Pro plan",
    "body_text": "Hi, I would like to learn more...",
    "attachments": []
  }'

curl -X POST https://yourapp.com/api/v1/webhooks \
  -H "Authorization: Bearer mf_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourcrm.com/webhooks/mailforge",
    "name": "CRM Sync",
    "events": [
      "contact.subscribed",
      "contact.unsubscribed",
      "email.opened",
      "email.clicked"
    ]
  }'

curl -H "Authorization: Bearer mf_key" https://yourapp.com/api/v1/campaigns/5

curl -X POST -H "Authorization: Bearer mf_key" https://yourapp.com/api/v1/campaigns/5/send

curl -H "Authorization: Bearer mf_key" "https://yourapp.com/api/v1/lists/1?page=1&per_page=25"

curl -X POST https://yourapp.com/api/v1/lists/1/contacts \
  -H "Authorization: Bearer mf_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'

<?php
// Install Guzzle: composer require guzzlehttp/guzzle
// Or use plain cURL (shown below)

$apiKey = 'mf_your_api_key_here';
$baseUrl = 'https://marketing.bithost.in/api/v1';

// ── Subscribe a contact ──────────────────────────
$ch = curl_init($baseUrl . '/contacts/subscribe');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'email'      => 'user@example.com',
    'first_name' => 'Priya',
    'last_name'  => 'Sharma',
    'list_id'    => 1,
    'tags'       => 'website,lead',
  ]),
]);
$response = curl_exec($ch);
$data     = json_decode($response, true);
curl_close($ch);

if ($data['success']) {
  echo 'Subscribed: ' . $data['data']['email'];
}

$page     = 1;
$perPage  = 25;
$url      = $baseUrl . "/contacts?page={$page}&per_page={$perPage}&status=active";

$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . $apiKey,
  ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($data['data'] as $contact) {
  echo $contact['email'] . PHP_EOL;
}
// Pagination info in $data['meta']
// total, pages, has_next, has_prev

$campaignId = 42;
$ch = curl_init($baseUrl . "/campaigns/{$campaignId}/send");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . $apiKey,
  ],
  CURLOPT_POSTFIELDS => '',
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $data['data']['message']; // "Campaign queued for sending."

// In your webhook endpoint (receives inbound email events)
$secret  = 'your_forward_secret_from_handler';
$payload = file_get_contents('php://input');
$sig     = $_SERVER['HTTP_X_MAILFORGE_SIGNATURE'] ?? '';

$expected = hash_hmac('sha256', $payload, $secret);

if (!hash_equals($expected, $sig)) {
  http_response_code(401);
  die('Invalid signature');
}

$event = json_decode($payload, true);
$email = $event['from_email'];
$subj  = $event['subject'];

// Process the inbound email event...
echo json_encode(['status' => 'ok']);

$contacts = [
  ['email' => 'alice@example.com', 'first_name' => 'Alice', 'company' => 'ACME'],
  ['email' => 'bob@example.com',   'first_name' => 'Bob'],
  // ... up to 500 per request
];

$ch = curl_init($baseUrl . '/contacts/bulk');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'contacts' => $contacts,
    'list_id'  => 1, // optional
  ]),
]);
$result = json_decode(curl_exec($ch), true)['data'];
curl_close($ch);

echo "Created: {$result['created']}, Updated: {$result['updated']}, Failed: {$result['failed']}";