---
title: "Provider catalog"
description: "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."
url: https://onesend.email/docs/providers/
---
# 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](https://onesend.email/research/email-provider-free-tiers/). 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](https://onesend.email/docs/domains-and-dns/#sending-providers).
- **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](https://onesend.email/docs/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.


<a id="suppression-sync-and-status-checks"></a>
## 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](https://onesend.email/docs/deliverability/#delivery-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](https://onesend.email/research/email-provider-free-tiers/#capacity). 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.
