Email that lands. Built for developers and their AI agents.

const res = await fetch("https://api.couryo.com/v1/emails", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COURYO_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "order-1042-confirmation",
  },
  body: JSON.stringify({
    from: "Acme Store <orders@example.com>",
    to: ["maria@example.com"],
    subject: "Your order 1042 is confirmed",
    html: "<p>Thanks for your purchase, Maria!</p>",
    tags: { type: "order" },
  }),
});

const email = await res.json(); // { id: "msg_...", status: "queued" }

$ch = curl_init('https://api.couryo.com/v1/emails');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('COURYO_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: order-1042-confirmation',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'from' => 'Acme Store <orders@example.com>',
        'to' => ['maria@example.com'],
        'subject' => 'Your order 1042 is confirmed',
        'html' => '<p>Thanks for your purchase, Maria!</p>',
    ]),
]);

$email = json_decode(curl_exec($ch), true); // ['id' => 'msg_...', 'status' => 'queued']

import os
import requests

res = requests.post(
    "https://api.couryo.com/v1/emails",
    headers={
        "Authorization": f"Bearer {os.environ['COURYO_API_KEY']}",
        "Idempotency-Key": "order-1042-confirmation",
    },
    json={
        "from": "Acme Store <orders@example.com>",
        "to": ["maria@example.com"],
        "subject": "Your order 1042 is confirmed",
        "html": "<p>Thanks for your purchase, Maria!</p>",
    },
)

email = res.json()  # {"id": "msg_...", "status": "queued"}

curl https://api.couryo.com/v1/emails \
  -H "Authorization: Bearer $COURYO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-confirmation" \
  -d '{
    "from": "Acme Store <orders@example.com>",
    "to": ["maria@example.com"],
    "subject": "Your order 1042 is confirmed",
    "html": "<p>Thanks for your purchase, Maria!</p>"
  }'

# 202 Accepted
# {"id": "msg_...", "status": "queued"}

# Any app or framework that sends over SMTP (Laravel .env example)
MAIL_MAILER=smtp
MAIL_HOST=smtp.couryo.com
MAIL_PORT=587            # STARTTLS. Also: 465 (TLS) and 2525
MAIL_USERNAME=couryo
MAIL_PASSWORD=ck_live_...  # your API key
MAIL_FROM_ADDRESS=orders@example.com