API reference
The Skrybo REST API
One base URL, one bearer token, seven endpoints. Speaks the same POST /v1/emails shape as Resend — migrate by changing the base URL. Full deep docs live under /docs.
Send a message
POST /v1/emails
curl
curl -X POST https://api.skrybo.com/v1/emails \
-H "Authorization: Bearer skrybo_live_xxx" \
-H "Content-Type: application/json" \
-d '{"from":"you@your-domain.com","to":["a@b.com"],"subject":"Hi","html":"<p>Hi</p>"}'JavaScript
import { Skrybo } from "skrybo";
const s = new Skrybo(process.env.SKRYBO_API_KEY);
await s.emails.send({
from: "you@your-domain.com",
to: ["a@b.com"],
subject: "Hi",
html: "<p>Hi</p>",
});Python
from skrybo import Skrybo
s = Skrybo(api_key=os.environ["SKRYBO_API_KEY"])
s.emails.send(
from_="you@your-domain.com",
to=["a@b.com"],
subject="Hi",
html="<p>Hi</p>",
)EndpointsEverything under
Everything under /v1
| Method | Path | Purpose |
|---|---|---|
POST | /v1/emails | Send a single transactional email (Resend-compatible shape). |
POST | /v1/emails/batch | Send up to 100 messages in one request. Same shape. |
GET | /v1/emails/:id | Retrieve delivery state, opens, clicks, bounces. |
GET | /v1/audiences | List audiences on the account. |
POST | /v1/audiences | Create a new audience for broadcasts. |
POST | /v1/audiences/:audienceId/contacts | Add a contact to an audience. |
GET | /v1/audiences/:audienceId/contacts | List contacts in an audience. |
GET | /v1/suppressions | List suppressions with reason + created_at. |
POST | /v1/suppressions | Add an address to your suppression list. |
SMTP relay
Standard SMTP, standard ports
- Host:
smtp.skrybo.com - Port: 587 (STARTTLS) or 465 (implicit TLS)
- Username:
apikey - Password:
skrybo_live_…— your developer API key
Webhook events
Standard Webhooks, HMAC-SHA256
| Event | When it fires |
|---|---|
email.sent | Message accepted by the relay. |
email.delivered | Recipient MTA confirmed delivery. |
email.bounced | Hard bounce (address suppressed). |
email.complained | Recipient marked as spam. |
email.opened | Tracking pixel loaded. |
email.clicked | A rewritten link was followed. |