Verify your domain to send emails from your own address. This builds trust with your audience and improves delivery rates.

Copy into your backend. Replace YOUR_API_KEY with your key above.

# Send a welcome email
curl -X POST https://app.betheloa.com/v1/send \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "to": { "email": "user@example.com", "name": "John Doe" },
    "subject": "Welcome to our platform!",
    "html": "<h1>Welcome John!</h1><p>Click <a href=\"https://yourapp.com\">here</a> to get started.</p>",
    "category": "welcome"
  }'

// Node.js — password reset
async function sendPasswordReset(userEmail, resetUrl) {
  const res = await fetch('https://app.betheloa.com/v1/send', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      to: { email: userEmail },
      subject: 'Reset your password',
      html: `<p>Click <a href="${resetUrl}">here</a> to reset your password.</p>
             <p>This link expires in 1 hour.</p>`,
      category: 'password_reset',
      tags: ['auth', 'reset']
    })
  });
  const data = await res.json();
  return data.message_id; // store for tracking
}

# Python — OTP / 2FA code
import requests

def send_otp(email: str, code: str):
    response = requests.post(
        'https://app.betheloa.com/v1/send',
        headers={
            'Content-Type': 'application/json',
            'X-API-Key': 'YOUR_API_KEY'
        },
        json={
            'to': {'email': email},
            'subject': f'Your verification code: {code}',
            'html': f'<p>Your one-time code is: <strong style="font-size:24px">{code}</strong></p><p>Expires in 10 minutes.</p>',
            'text': f'Your code is: {code}',
            'category': 'otp'
        }
    )
    return response.json()['message_id']

// PHP — order confirmation
function sendOrderConfirmation($email, $orderId, $amount) {
    $payload = json_encode([
        'to'       => ['email' => $email],
        'subject'  => "Order #{$orderId} confirmed",
        'html'     => "<h2>Thank you!</h2><p>Order #{$orderId} — ₦" . number_format($amount) . " has been received.</p>",
        'category' => 'order_confirmation',
        'tags'     => ['ecommerce', 'receipt']
    ]);
    $ch = curl_init('https://app.betheloa.com/v1/send');
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $payload,
        CURLOPT_HTTPHEADER     => ['Content-Type: application/json', 'X-API-Key: YOUR_API_KEY']
    ]);
    return json_decode(curl_exec($ch), true)['message_id'];
}