Saltar al contenido
Referencia de la API

La API REST de Skrybo

Una URL base, un token bearer, siete endpoints. El mismo formato POST /v1/emails que Resend: para migrar basta con cambiar la URL base. La documentación completa vive en /docs.

Enviar un mensaje

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

Todo lo que hay bajo /v1

MétodoRutaFunción
POST/v1/emailsEnviar un correo transaccional (formato compatible con Resend).
POST/v1/emails/batchEnviar hasta 100 mensajes en una petición. Mismo formato.
GET/v1/emails/:idConsultar el estado de entrega, aperturas, clics y rebotes.
GET/v1/audiencesListar las audiencias de la cuenta.
POST/v1/audiencesCrear una audiencia para campañas.
POST/v1/audiences/:audienceId/contactsAñadir un contacto a una audiencia.
GET/v1/audiences/:audienceId/contactsListar los contactos de una audiencia.
GET/v1/suppressionsListar las supresiones con su motivo y created_at.
POST/v1/suppressionsAñadir una dirección a tu lista de supresiones.
Relé SMTP

SMTP estándar, puertos estándar

  • Host: smtp.skrybo.com
  • Puerto: 587 (STARTTLS) o 465 (TLS implícito)
  • Usuario: apikey
  • Contraseña: skrybo_live_…tu clave de API para desarrolladores
Eventos de webhook

Standard Webhooks, HMAC-SHA256

EventoCuándo se dispara
email.sentEl relé aceptó el mensaje.
email.deliveredEl MTA del destinatario confirmó la entrega.
email.bouncedRebote definitivo (dirección suprimida).
email.complainedEl destinatario lo marcó como spam.
email.openedSe cargó el píxel de seguimiento.
email.clickedSe siguió un enlace reescrito.

Preguntas frecuentes