Zum Inhalt springen
API-Referenz

Die REST-API von Skrybo

Eine Basis-URL, ein Bearer-Token, sieben Endpunkte. Dasselbe Format POST /v1/emails wie bei Resend — für die Migration genügt eine geänderte Basis-URL. Die ausführliche Dokumentation liegt unter /docs.

Eine Nachricht senden

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>",
)
Endpunkte

Alles unter /v1

MethodePfadZweck
POST/v1/emailsEine einzelne transaktionale E-Mail senden (zu Resend kompatibles Format).
POST/v1/emails/batchBis zu 100 Nachrichten in einer Anfrage senden. Gleiches Format.
GET/v1/emails/:idZustellstatus, Öffnungen, Klicks und Unzustellbarkeiten abrufen.
GET/v1/audiencesZielgruppen des Kontos auflisten.
POST/v1/audiencesEine neue Zielgruppe für Kampagnen anlegen.
POST/v1/audiences/:audienceId/contactsEinen Kontakt zu einer Zielgruppe hinzufügen.
GET/v1/audiences/:audienceId/contactsKontakte einer Zielgruppe auflisten.
GET/v1/suppressionsSperrlisteneinträge mit Grund und created_at auflisten.
POST/v1/suppressionsEine Adresse zu Ihrer Sperrliste hinzufügen.
SMTP-Relay

Standard-SMTP, Standardports

  • Host: smtp.skrybo.com
  • Port: 587 (STARTTLS) oder 465 (implizites TLS)
  • Benutzername: apikey
  • Passwort: skrybo_live_…Ihr Entwickler-API-Schlüssel
Webhook-Ereignisse

Standard Webhooks, HMAC-SHA256

EreignisWann es ausgelöst wird
email.sentNachricht vom Relay angenommen.
email.deliveredDer MTA des Empfängers hat die Zustellung bestätigt.
email.bouncedEndgültig unzustellbar (Adresse gesperrt).
email.complainedDer Empfänger hat die Nachricht als Spam gemeldet.
email.openedDas Zählpixel wurde geladen.
email.clickedEin umgeschriebener Link wurde geöffnet.

Häufige Fragen