Introduction

curl https://sendhawk.online/api/emails \
  -H "Authorization: Bearer $SENDHAWK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": "you@example.com",
    "subject": "Hello from SendHawk.Online",
    "html": "<p>It works.</p>",
    "text": "It works."
  }'

// Node.js 18 or later ships fetch. Save as send.mjs and run: node send.mjs
const response = await fetch('https://sendhawk.online/api/emails', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SENDHAWK_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    from: 'hello@yourdomain.com',
    to: 'you@example.com',
    subject: 'Hello from SendHawk.Online',
    html: '<p>It works.</p>',
    text: 'It works.'
  })
})

const result = await response.json()
if (!response.ok) throw new Error(`${response.status} ${result.message}`)

console.log(result.id)

# pip install requests
import os

import requests

response = requests.post(
    "https://sendhawk.online/api/emails",
    headers={"Authorization": f"Bearer {os.environ['SENDHAWK_API_KEY']}"},
    json={
        "from": "hello@yourdomain.com",
        "to": "you@example.com",
        "subject": "Hello from SendHawk.Online",
        "html": "<p>It works.</p>",
        "text": "It works.",
    },
    timeout=10,
)

if not response.ok:
    raise RuntimeError(f"{response.status_code} {response.json()['message']}")

print(response.json()["id"])

<?php
// Needs the curl and json extensions, which most PHP builds include.
$ch = curl_init('https://sendhawk.online/api/emails');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SENDHAWK_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'from' => 'hello@yourdomain.com',
        'to' => 'you@example.com',
        'subject' => 'Hello from SendHawk.Online',
        'html' => '<p>It works.</p>',
        'text' => 'It works.',
    ]),
]);

$body = curl_exec($ch);
if ($body === false) {
    throw new RuntimeException(curl_error($ch));
}

$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$result = json_decode($body, true);
if ($status < 200 || $status >= 300) {
    throw new RuntimeException("$status {$result['message']}");
}

echo $result['id'], PHP_EOL;