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").
ProviderCredentialsFree tier (checked November 8–9, 2026)Domains via APIQuota via APINotes
ResendAPI key100/day, 3,000/month (received mail counts too)YesYes (x-resend-daily-quota header)Batch up to 100
BrevoAPI key (v3)300/day, no expiryYesYes (account credits)Transactional and marketing
Cloudflare Email ServiceAccount ID and API token (Email Sending: Edit; DNS edit for automatic DNS)No free sending to any recipient; Workers Paid includes 3,000/monthYes (domain onboarding)No (learned)Also used for inbound through Email Routing
Amazon SESAccess key, secret, regionNo SES free tier for new customers since July 21, 2026; AWS credits can applyYes (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
MailgunAPI key, region (US or EU), domain100/dayYesNo
SMTP2GOAPI key200/day, 1,000/monthYes (sender domains)Yes
MailerSendAPI token500/month (card required)YesYes
MailjetAPI key and secret200/day, 6,000/monthYes (sender domains)No
PostmarkServer token (and account token for domains)100/monthYes (account token)NoSeparate message streams for broadcasts
ZeptoMailSend-mail tokenOne-time 10,000-email creditNoNoZoho's transactional service
Elastic EmailAPI key100/day, 3,000/monthNoNo
SendGridAPI key60-day trial, 100/dayYesYes
SparkPostAPI key, regionBird Free: 50/day, 1,000/monthYesNo
PlunkAPI key1,000/monthNoNoOpen source; campaigns on the free plan
MailtrapAPI token; stream (transactional or bulk)150/day, 4,000/monthYesNoWebhooks signed with HMAC-SHA256 (Mailtrap-Signature)
MailChannelsAPI key (Sending Email scope)100/day; a payment method on file is needed to send to any recipientNo (Domain Lockdown TXT record)NoWebhooks signed with Ed25519 (RFC 9421) and always verified
AhaSendAPI key and account ID1,000/monthYesNoStandard Webhooks signatures; cc and bcc recipients get separate copies (the message API has no cc or bcc)
LettermintProject API token; optional route300/monthNoNoWebhooks signed with HMAC-SHA256 (X-Lettermint-Signature)
PostalServer API key, server URL; optional webhook public keySelf-hosted (open source)NoNoWebhooks signed with RSA SHA-256 (X-Postal-Signature-256); the server URL goes through the SSRF guard
Mailchimp Transactional (Mandrill)API key; optional webhook keyNone: paid add-on to a Mailchimp plan (demo: 500 emails to your own domain)NoNoWebhooks signed with HMAC-SHA1 over the webhook URL and fields
SocketLabsServer ID and Injection API keyFirst month free on Core (40,000 emails), then paidNoNoSending only
InfobipAPI key and base URL60-day trial with 100 emailsNoNoNo webhooks (push format not documented); status checks instead
Scaleway Transactional EmailSecret key and Project ID (region fr-par)300/month, transactional onlyNoNoNo webhooks (Scaleway delivers them through Topics and Events); status checks instead
Azure Communication Services EmailConnection stringNone: USD 0.00025 per emailNoNoSending only; default limits 30/minute and 100/hour on custom domains
SMTP (any server)Host, port, security, user, passwordGmail 500/day; Google Workspace 2,000/day per paid userNoNoGmail, Zoho, Fastmail, Postfix and others; see SMTP
SandboxNoneUnlimited, delivers nothingYes (simulated)NoSimulates 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.

ProviderSuppression list importPushStatus checksAPI used
Amazon SESYes: account-level list, bounces and complaints, by dateYes (bounces, complaints)NoListSuppressedDestinations, PutSuppressedDestination (SESv2). Key needs ses:ListSuppressedDestinations (and ses:PutSuppressedDestination for push). No per-message status without Virtual Deliverability Manager
BrevoYes: transactional blocked contacts (hard bounces, spam, unsubscribes, admin blocks), by dateNoYesGET /smtp/blockedContacts, GET /smtp/statistics/events?messageId=
MailgunYes: bounces, complaints and unsubscribes of each sending domain (up to 20). No date filter: every pass reads the listsYesYes/v3/{domain}/bounces, /complaints, /unsubscribes, /events?message-id=
PostmarkYes: every outbound message stream, by dateYes (the connection's stream)Yes/message-streams/{stream}/suppressions/dump, /messages/outbound/{id}/details
SendGridYes: bounces, blocks (temporary), spam reports, invalid emails, global unsubscribes, by dateNo (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
ResendNo: 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 everywhereNoYesGET /emails/{id} (last_event)
SparkPostYes: suppression list (non-transactional entries apply to campaigns only), by dateYesNo/api/v1/suppression-list
MailtrapYes: hard bounces, unsubscriptions, spam complaints and manual entries (bulk-stream entries apply to campaigns only), by dateNoYesGET /api/suppressions (10 requests/minute), GET /api/email_logs/{id}
MailChannelsYes: suppression list (non-transactional entries apply to campaigns only), by dateNoNo: no per-message status APIGET /tx/v1/suppression-list
AhaSendYes: suppressions, by dateNoYesGET /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 filterNoYesrejects/list, messages/info
InfobipYes: bounces, complaints and over-quota entries of each domain, by dateNoYes/email/1/suppressions, /email/1/logs
Scaleway Transactional EmailYes: blocklist of each domain of the Project (mailbox full as temporary), no date filterNoYes/blocklists, /emails/{id}
PostalNo: the HTTP API has no suppression list—Yes/api/v1/messages/deliveries
OthersNo. 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 (transactionalId and 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 (/send or /v1/email/send) and on how custom headers are passed.

Adding a provider

  1. Create packages/core/src/providers/<id>.ts implementing ProviderAdapter (types.ts): manifest, validate and send, and optionally detectQuota, domains, webhooks, listSuppressions, pushSuppressions and getStatus (with apiPacing and the matching manifest capabilities).
  2. Map every provider error to retry_next, retry_same, recipient_fatal or config_fatal with a normalized code (quota_exceeded, rate_limited, unauthorized, domain_unverified, invalid_recipient and others). Failover is safe only when this classification is right.
  3. Register it in registry.ts and add tests with a mocked fetch; CI has no network access.
  4. Add a row to this table with the capability values from your manifest.
  5. Open a pull request with a link to the provider's API documentation for each endpoint you call.