Docs / Start here
Provider catalog
OneSend connects to email providers through adapters. Each provider is one adapter file (packages/core/src/providers/<id>.ts) with a manifest that describes its credentials, capabilities and typical free tier. GET /v1/providers returns the catalog your server supports.
Free-tier figures below were checked on November 8, 2026 (providers added later: November 9, 2026) against each provider's official pages. Sources, conditions and conflicts are in the free tier comparison. OneSend reads the real quota from the provider API where it can, and otherwise lets you set it.
The two capability columns come from each adapter's manifest (capabilities.domains and capabilities.quotaApi):
- Domains via API: OneSend can register and verify your sending domain with the provider. Without it, add the domain in the provider's own dashboard.
The router uses the same flag: a provider with Domains via API sends for a domain only after it reports that domain verified; a provider without it (SMTP, for example) does not verify domains per sending domain and is eligible for every domain. Free plans often limit how many domains you can add (one on some, three on others). Choose which providers send for each domain under Sending providers on the domain page, so a provider is never asked to send from a domain it does not have. See Which providers send for a domain.
- Quota via API: OneSend reads the remaining quota from the provider. Without it, OneSend counts sends itself against the known or configured limit, and lowers the limit when the provider refuses sends ("learned").
| Provider | Credentials | Free tier (checked November 8–9, 2026) | Domains via API | Quota via API | Notes |
|---|---|---|---|---|---|
| Resend | API key | 100/day, 3,000/month (received mail counts too) | Yes | Yes (x-resend-daily-quota header) | Batch up to 100 |
| Brevo | API key (v3) | 300/day, no expiry | Yes | Yes (account credits) | Transactional and marketing |
| Cloudflare Email Service | Account ID and API token (Email Sending: Edit; DNS edit for automatic DNS) | No free sending to any recipient; Workers Paid includes 3,000/month | Yes (domain onboarding) | No (learned) | Also used for inbound through Email Routing |
| Amazon SES | Access key, secret, region | No SES free tier for new customers since July 21, 2026; AWS credits can apply | Yes (identities, Easy DKIM) | Yes (send quota) | New accounts start in the SES sandbox until you request production access. Events arrive through Amazon SNS: every SNS message must carry a valid signature (SignatureVersion 1 or 2, certificate from sns.<region>.amazonaws.com) and come to the webhook URL with its secret token |
| Mailgun | API key, region (US or EU), domain | 100/day | Yes | No | |
| SMTP2GO | API key | 200/day, 1,000/month | Yes (sender domains) | Yes | |
| MailerSend | API token | 500/month (card required) | Yes | Yes | |
| Mailjet | API key and secret | 200/day, 6,000/month | Yes (sender domains) | No | |
| Postmark | Server token (and account token for domains) | 100/month | Yes (account token) | No | Separate message streams for broadcasts |
| ZeptoMail | Send-mail token | One-time 10,000-email credit | No | No | Zoho's transactional service |
| Elastic Email | API key | 100/day, 3,000/month | No | No | |
| SendGrid | API key | 60-day trial, 100/day | Yes | Yes | |
| SparkPost | API key, region | Bird Free: 50/day, 1,000/month | Yes | No | |
| Plunk | API key | 1,000/month | No | No | Open source; campaigns on the free plan |
| Mailtrap | API token; stream (transactional or bulk) | 150/day, 4,000/month | Yes | No | Webhooks signed with HMAC-SHA256 (Mailtrap-Signature) |
| MailChannels | API key (Sending Email scope) | 100/day; a payment method on file is needed to send to any recipient | No (Domain Lockdown TXT record) | No | Webhooks signed with Ed25519 (RFC 9421) and always verified |
| AhaSend | API key and account ID | 1,000/month | Yes | No | Standard Webhooks signatures; cc and bcc recipients get separate copies (the message API has no cc or bcc) |
| Lettermint | Project API token; optional route | 300/month | No | No | Webhooks signed with HMAC-SHA256 (X-Lettermint-Signature) |
| Postal | Server API key, server URL; optional webhook public key | Self-hosted (open source) | No | No | Webhooks signed with RSA SHA-256 (X-Postal-Signature-256); the server URL goes through the SSRF guard |
| Mailchimp Transactional (Mandrill) | API key; optional webhook key | None: paid add-on to a Mailchimp plan (demo: 500 emails to your own domain) | No | No | Webhooks signed with HMAC-SHA1 over the webhook URL and fields |
| SocketLabs | Server ID and Injection API key | First month free on Core (40,000 emails), then paid | No | No | Sending only |
| Infobip | API key and base URL | 60-day trial with 100 emails | No | No | No webhooks (push format not documented); status checks instead |
| Scaleway Transactional Email | Secret key and Project ID (region fr-par) | 300/month, transactional only | No | No | No webhooks (Scaleway delivers them through Topics and Events); status checks instead |
| Azure Communication Services Email | Connection string | None: USD 0.00025 per email | No | No | Sending only; default limits 30/minute and 100/hour on custom domains |
| SMTP (any server) | Host, port, security, user, password | Gmail 500/day; Google Workspace 2,000/day per paid user | No | No | Gmail, Zoho, Fastmail, Postfix and others; see SMTP |
| Sandbox | None | Unlimited, delivers nothing | Yes (simulated) | No | Simulates outages, quota exhaustion and bounces |
The dashboard's provider list under Sending providers shows what your server supports.
Suppression sync and status checks
Optional adapter capabilities (0025): listSuppressions imports the provider's own suppression list into the workspace list, pushSuppressions adds ours to it (only with providerSync.push, off by default), and getStatus reads the delivery status of one message for status checks. Manifests say so in capabilities.suppressionSync, suppressionPush and statusPolling.
| Provider | Suppression list import | Push | Status checks | API used |
|---|---|---|---|---|
| Amazon SES | Yes: account-level list, bounces and complaints, by date | Yes (bounces, complaints) | No | ListSuppressedDestinations, PutSuppressedDestination (SESv2). Key needs ses:ListSuppressedDestinations (and ses:PutSuppressedDestination for push). No per-message status without Virtual Deliverability Manager |
| Brevo | Yes: transactional blocked contacts (hard bounces, spam, unsubscribes, admin blocks), by date | No | Yes | GET /smtp/blockedContacts, GET /smtp/statistics/events?messageId= |
| Mailgun | Yes: bounces, complaints and unsubscribes of each sending domain (up to 20). No date filter: every pass reads the lists | Yes | Yes | /v3/{domain}/bounces, /complaints, /unsubscribes, /events?message-id= |
| Postmark | Yes: every outbound message stream, by date | Yes (the connection's stream) | Yes | /message-streams/{stream}/suppressions/dump, /messages/outbound/{id}/details |
| SendGrid | Yes: bounces, blocks (temporary), spam reports, invalid emails, global unsubscribes, by date | No (only global unsubscribes could be added, which would mislabel bounces) | Only with the paid Email Activity add-on (messages.read); otherwise shown as not offered | /v3/suppression/*, /v3/messages |
| Resend | No: the public API has no suppression list endpoint (checked 2026-11-09). Addresses Resend suppresses are learned from email.suppressed (webhook or status check) and suppressed everywhere | No | Yes | GET /emails/{id} (last_event) |
| SparkPost | Yes: suppression list (non-transactional entries apply to campaigns only), by date | Yes | No | /api/v1/suppression-list |
| Mailtrap | Yes: hard bounces, unsubscriptions, spam complaints and manual entries (bulk-stream entries apply to campaigns only), by date | No | Yes | GET /api/suppressions (10 requests/minute), GET /api/email_logs/{id} |
| MailChannels | Yes: suppression list (non-transactional entries apply to campaigns only), by date | No | No: no per-message status API | GET /tx/v1/suppression-list |
| AhaSend | Yes: suppressions, by date | No | Yes | GET /v2/accounts/{id}/suppressions, GET …/messages/{id} |
| Mailchimp Transactional (Mandrill) | Yes: active reject list entries (soft bounces as temporary), up to 1,000, no date filter | No | Yes | rejects/list, messages/info |
| Infobip | Yes: bounces, complaints and over-quota entries of each domain, by date | No | Yes | /email/1/suppressions, /email/1/logs |
| Scaleway Transactional Email | Yes: blocklist of each domain of the Project (mailbox full as temporary), no date filter | No | Yes | /blocklists, /emails/{id} |
| Postal | No: the HTTP API has no suppression list | — | Yes | /api/v1/messages/deliveries |
| Others | No. Cloudflare, Mailjet, Plunk, Lettermint (its Team API only), SocketLabs, Azure and SMTP offer no suppression API that OneSend uses; MailerSend, SMTP2GO, Elastic Email and ZeptoMail are not synced | — | — |
Sync runs at the API rates OneSend keeps to (SES 1 request/second, others 2 to 3), with bounded pages; a 429 waits for the time the provider asks. Errors (missing key permission, rate limits) show on the Suppressions page and the provider page, without secrets.
Combined free capacity
Connecting all 15 permanent free plans gives about 1,204 emails per day (36,200 per month). See how this is calculated. Use one account per provider, order them in a routing policy, and the Dashboard page shows the combined total.
Providers not supported
- Loops: its transactional API sends a template built in Loops (
transactionalIdand data variables); it takes no subject or HTML, so OneSend's rendered messages cannot be sent through it. - Sweego: the API reference renders only with JavaScript, and the sources that could be read disagree on the send endpoint (
/sendor/v1/email/send) and on how custom headers are passed.
Adding a provider
- Create
packages/core/src/providers/<id>.tsimplementingProviderAdapter(types.ts):manifest,validateandsend, and optionallydetectQuota,domains,webhooks,listSuppressions,pushSuppressionsandgetStatus(withapiPacingand the matching manifest capabilities). - Map every provider error to
retry_next,retry_same,recipient_fatalorconfig_fatalwith a normalized code (quota_exceeded,rate_limited,unauthorized,domain_unverified,invalid_recipientand others). Failover is safe only when this classification is right. - Register it in
registry.tsand add tests with a mockedfetch; CI has no network access. - Add a row to this table with the capability values from your manifest.
- Open a pull request with a link to the provider's API documentation for each endpoint you call.