Skip to content
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>",
)
Endpoints

Everything under /v1

MethodPathPurpose
POST/v1/emailsSend a single transactional email (Resend-compatible shape).
POST/v1/emails/batchSend up to 100 messages in one request. Same shape.
GET/v1/emails/:idRetrieve delivery state, opens, clicks, bounces.
GET/v1/audiencesList audiences on the account.
POST/v1/audiencesCreate a new audience for broadcasts.
POST/v1/audiences/:audienceId/contactsAdd a contact to an audience.
GET/v1/audiences/:audienceId/contactsList contacts in an audience.
GET/v1/suppressionsList suppressions with reason + created_at.
POST/v1/suppressionsAdd 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

EventWhen it fires
email.sentMessage accepted by the relay.
email.deliveredRecipient MTA confirmed delivery.
email.bouncedHard bounce (address suppressed).
email.complainedRecipient marked as spam.
email.openedTracking pixel loaded.
email.clickedA rewritten link was followed.

Frequently asked questions