Coming soon. The SMTP relay is not live yet: smtp.couryo.com does not accept connections for now. Today, send through the REST API, which already has idempotency, batches and attachments. This page shows how it will work.

For apps, frameworks and tools that already send over SMTP, swapping the credentials will be enough.

Credentials#

Field	Value
Host	`smtp.couryo.com`
Port	`587` (STARTTLS), `465` (implicit TLS) or `2525` (when 587 is blocked)
Username	`couryo`
Password	your API key (`ck_live_...` or `ck_test_...`) with the `send` scope

The sender must be on a verified domain, as with the API. ck_test_ keys also work over SMTP and capture the email without delivering it.

Laravel#

.env

MAIL_MAILER=smtp
MAIL_HOST=smtp.couryo.com
MAIL_PORT=587
MAIL_USERNAME=couryo
MAIL_PASSWORD=ck_live_...
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=hi@example.com
MAIL_FROM_NAME="Example"

Node.js (Nodemailer)#

Node.js

import nodemailer from "nodemailer";

const transport = nodemailer.createTransport({
  host: "smtp.couryo.com",
  port: 587,
  secure: false, // STARTTLS
  auth: { user: "couryo", pass: process.env.COURYO_API_KEY },
});

await transport.sendMail({
  from: "Example <hi@example.com>",
  to: "ana@example.com",
  subject: "Hello",
  text: "Sent through Couryo over SMTP.",
});

Supabase Auth and other tools#

In tools with a "custom SMTP" setting (Supabase Auth, WordPress, n8n and similar), fill in host, port, username and password from the table above.

API or SMTP?#

	API	SMTP
Idempotency	yes, with `Idempotency-Key`	no
Message `id` in the response	yes	yes, in the `DATA` response
Batch of up to 100 per request	yes	no
Code change	small	none

Once SMTP is live, both paths will create the same events, show on the same timeline and call the same webhooks.