# Scribase Mail: a Resend-compatible email API

> Scribase Mail: a hosted, Resend-compatible transactional email API with verified domains, signed webhooks, test mode and teams.

Source: https://scribase.com/mail

Hosted at https://mail.scribase.com. API at https://mail-api.scribase.com. Docs at https://scribase.com/mail/docs/. Hosted only; the source is not public and there is no self-hosted build. Mail is delivered through the Oracle Cloud Email Delivery relay, DKIM-signed with your domain key.

## Plans (from the live /billing/plans endpoint)

**Free** — $0/mo. For trying the API and low-volume apps. No card. 3,000 emails a month, 100 emails a day, 1 domain, 1 webhook endpoint, 10 MB per message.

**Pro** — $20/mo. For products sending to real customers. 50,000 emails a month, No daily cap, 10 domains, 5 webhook endpoints, 40 MB per message, $0.80 per 1,000 extra emails.

**Scale** — $90/mo. For teams with high volume and many domains. 150,000 emails a month, No daily cap, 1,000 domains, 20 webhook endpoints, 40 MB per message, $0.60 per 1,000 extra emails.

## Features (live today)

- **SMTP submission** — Host smtp.scribase.com, port 465 (TLS) or 587 (STARTTLS), username scribase, password your sk_ API key. Point Supabase Auth custom SMTP, nodemailer, Rails or WordPress at it: the message is DKIM-signed, checked against your suppression list and logged like an API send.

- **Resend-compatible sending** — POST /emails and /emails/batch take the same body: from, to, cc, bcc, reply_to, subject, html, text, headers, attachments, tags and scheduled_at. Idempotency-Key is honoured. Get, reschedule and cancel by id.

- **Domains with real DNS checks** — Add a domain and get the DKIM, SPF and DMARC records to publish. Verify checks live DNS and marks the domain verified when the records resolve.

- **Signed webhooks** — email.sent, delivered, delivery_delayed, bounced, complained, opened and clicked, signed with a whsec_ secret in the Standard Webhooks format (webhook-id, webhook-timestamp, webhook-signature), also sent as svix-* headers so resend.webhooks.verify() works unchanged. Every delivery attempt is logged.

- **Test mode** — Create an sk_test_ key: sends are simulated and never delivered, not metered, and need no verified domain. Recipients on test.scribase.dev script the outcome (bounced@, complained@, delayed@, suppressed@).

- **Tracking and unsubscribe** — Open and click tracking, switched per domain. One-click unsubscribe headers (RFC 8058) with a hosted unsubscribe page, and a per-account suppression list the sender honours.

- **Keys, teams and usage** — Full-access or sending-only keys, optionally locked to one domain. Teams with owner, admin, developer and viewer roles, magic-link sign-in, usage and an audit log in the dashboard.

## API resources

- **Emails**: POST /emails; POST /emails/batch; GET /emails; GET /emails/:id; PATCH /emails/:id (reschedule); POST /emails/:id/cancel; GET /emails/:id/events; GET /emails/:id/webhook-deliveries

- **Domains**: POST /domains; GET /domains; GET /domains/:id; PATCH /domains/:id; DELETE /domains/:id; POST /domains/:id/verify

- **API keys**: POST /api-keys; GET /api-keys; DELETE /api-keys/:id

- **Webhooks**: POST /webhooks; GET /webhooks; GET /webhooks/:id; PATCH /webhooks/:id; DELETE /webhooks/:id; GET /webhooks/:id/deliveries

- **Suppressions**: GET /suppressions; POST /suppressions; DELETE /suppressions/:address

- **Usage and billing**: GET /usage; GET /audit-log; GET /billing; GET /billing/plans

- **Teams**: GET, POST /accounts; GET, PATCH /accounts/:id; GET, POST /accounts/:id/members; PATCH, DELETE /accounts/:id/members/:userId

- **Sign-in emails for your app**: POST /auth/magic-link; POST /auth/otp; POST /auth/otp/verify; GET /auth/verify; GET /.well-known/jwks.json

## Not yet built (stated honestly)

- Contacts, audiences, segments and topics (/contacts, /audiences, /segments)
- Broadcasts and templates (/broadcasts, /templates)
- Inbound email (/emails/received) and attachment download
- Automations, the Inboxes API and OAuth apps

## Compared to Resend and Postal

|  | Scribase Mail | Resend | Postal |
| --- | --- | --- | --- |
| Works with the resend SDK (baseUrl) | yes | yes | no |
| Hosted plan | yes | yes | no |
| Sending path | Oracle Cloud Email Delivery relay | Managed | Own MTA and IPs |
| Signed webhooks | Standard Webhooks + svix-* headers | Svix | no |
| Test mode keys | yes | Test addresses | no |
| SMTP submission (Supabase custom SMTP, nodemailer) | yes, 465 and 587 | yes | yes |
| Contacts and broadcasts | Not yet | yes | no |
| Inbound email | Not yet | yes | yes |
| Hosted price for 50,000 emails a month | $20 | $20 | Your servers |

## Send an email (curl)

```bash
curl -X POST https://mail-api.scribase.com/emails \
  -H "Authorization: Bearer $SCRIBASE_MAIL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": ["you@example.com"],
    "subject": "It works",
    "html": "<p>Sent through Scribase Mail.</p>"
  }'
```

## Switch the resend Node SDK

```ts
import { Resend } from 'resend';

// Before: const resend = new Resend(process.env.RESEND_API_KEY);
const resend = new Resend(process.env.SCRIBASE_MAIL_KEY, {
  baseUrl: 'https://mail-api.scribase.com',
});

await resend.emails.send({
  from: 'Acme <hello@acme.com>',
  to: ['you@example.com'],
  subject: 'It works',
  html: '<p>Sent through Scribase Mail.</p>',
});
```