[ Platform guides ]

Transactional email API selection: test identity control and delivery evidence

Select a transactional email API by proving identity control, event meaning and recovery on your own workflows.

By the EmailAuth research team · 3 min read

[ Key points ]

  • Select a transactional email API by proving identity control, event meaning and recovery on your own workflows.
  • Keep API submission, aligned authentication, remote acceptance and recovery requirements separate.
On this page

A successful API response is not the same as authenticated delivery. Before comparing prices or SDK convenience, define what the service must prove about the sender identity and the lifecycle of a message. This guide supplies a vendor-neutral acceptance method, not a ranked provider list or a claim that any specific plan supports every feature.

Specify the messages that matter

List password resets, receipts, security alerts and other transactional flows separately. For each, record the desired From domain, application owner, maximum useful delay, expected volume pattern and duplicate-message consequence. Include scheduled messages and alternate environments. Decide which flows must survive a provider incident and which can safely wait.

Ask each shortlisted provider for current first-party documentation covering custom signing domains, envelope-domain options, credential scope, event delivery and retention. Record plan and region restrictions. A salesperson's demonstration is not evidence that your proposed account includes the same capability. Keep unanswered questions visible rather than assigning optimistic scores.

Prove control of the identities

Set up a dedicated test subdomain through the documented domain-verification process. Use generated DNS values from that account. Preserve other authorised senders in any existing SPF policy and avoid duplicate SPF records at a single owner. Send through the actual API endpoint and message type intended for production.

At a controlled mailbox, capture visible From, envelope domain, DKIM d and s, and trusted authentication results. A passing signature for the provider's unrelated domain does not demonstrate DMARC alignment with yours. One aligned passing path can satisfy DMARC, but custom envelope control can still matter for bounce ownership or another business requirement. Score those requirements separately.

Define what each event means

Build an event dictionary from provider documentation: accepted, queued, delivered, deferred, bounced and complained are not interchangeable outcomes. Ask whether a delivered event means acceptance by the remote SMTP server rather than inbox placement. Test authentication of webhook requests, duplicate event handling, ordering and retry behaviour according to the supported interface.

Use a stable internal message identifier to connect application intent, API submission, provider identifier and recipient outcome. If a submission times out, do not automatically resend without considering whether the provider already accepted it. Require documented idempotency semantics or a recovery procedure suitable for that API. Do not assume every provider exposes the same deduplication feature.

Run a reversible selection exercise

Illustrative acceptance worksheet: a receipt must use an aligned example.org identity; a timed-out submission must not generate two receipts; a deferred event must be visible to the operations owner; a disabled credential must stop further submissions. Mark each result demonstrated, documented-only, unsupported or not tested. No provider or live test result is implied by this example.

Test representative content and attachments within the provider's rules. Use controlled recipients and synthetic payloads rather than customer data. Measure latency for the defined workflow and observation window, and retain raw timestamps. Do not extrapolate a small pilot into an uptime or inbox-placement guarantee.

Decide with an exit plan

Treat unmet identity or recovery requirements as gates before cost scoring. Include DNS cleanup, credential revocation, retained event export and suppression handling in the exit plan. Validate a backup route before calling it a failover strategy. After selection, repeat identity and event checks when plans, domains, SDKs or routing change. The useful deliverable is a signed-off requirement matrix and reproducible test record, not a feature-count winner.

Resolve an ambiguous submission before retrying

Suppose the application records request DEMO-42, the API connection times out and no provider message ID is returned. The outcome is unknown, not failed. Use the service’s documented reconciliation or idempotency process, record the evidence and escalate if it cannot establish whether acceptance occurred. Blindly generating a new request risks duplicate receipts. This is a hypothetical recovery decision; no provider was queried and no message was submitted. RFC 9989 Section 5.3.5 describes DMARC evaluation, not API idempotency or business-event completion.

Respect the sender obligations before reject

RFC 9989 Section 7.4 requires domains publishing p=reject to apply valid DKIM signatures and not rely solely on SPF for DMARC passage. Section 8 separately states full-participation requirements, including aligned SPF and DKIM. A single message’s passing aligned mechanism is therefore not a complete deployment-readiness standard. Section 7.4 also warns about indirect flows and recommends against reject for domains hosting users who might post to mailing lists; its staged observation guidance does not replace checking the actual business cycles and affected paths.

[ Takeaway ]

Keep API submission, aligned authentication, remote acceptance and recovery requirements separate.

[ By role ]

What this means for you

Choose your role for practical next steps.

IT / Mail Admin

Keep operational evidence

Keep a correlation trail from application request to received message and event stream. Treat ambiguous submission outcomes as a recovery case.

Next steps

  1. Keep a correlation trail from application request to received message and event stream.
  2. Treat ambiguous submission outcomes as a recovery case.
  3. Reconcile a timed-out API submission.

CISO / SecOps

Review the trust boundary

Assess domain authorisation, credential scope and webhook authenticity. Do not put production secrets or customer payloads into comparison exercises.

Next steps

  1. Assess domain authorisation, credential scope and webhook authenticity.
  2. Do not put production secrets or customer payloads into comparison exercises.
  3. Test event-consumer authentication.

Founder / Non-technical

Own the business decision

Approve mandatory identity and recovery requirements before comparing subscription prices. Include migration effort and incident ownership in the decision.

Next steps

  1. Approve mandatory identity and recovery requirements before comparing subscription prices.
  2. Include migration effort and incident ownership in the decision.
  3. Set a must-pass identity gate.

[ FAQs ]

Frequently asked questions

Is HTTP success proof of email delivery?

No. Interpret the response and later events using that API’s documentation, then separate remote acceptance from inbox placement.

Must the API support a custom return path?

It depends on the requirements. Aligned DKIM can satisfy DMARC, while envelope control may matter for other operational reasons.

How should I compare plans?

Mark each required capability as demonstrated, documented-only, unsupported or untested for the exact plan and region.

Can I reuse another account’s DNS targets?

No. Use the values generated or documented for the selected account and domain.

What should happen after a submission timeout?

Reconcile the possible accepted request using the provider’s documented identifiers or idempotency mechanism before resending.

Are webhook events always ordered?

Do not assume that. Verify documented ordering, retries and duplicates and test the consumer accordingly.

Does a pilot prove inbox placement?

Only the observations made in that pilot. It does not establish a general delivery guarantee.

What belongs in the exit test?

Revoke credentials, retire unused DNS trust, preserve required evidence and verify that any replacement route handles the same workflows.

[ Sources ]

Sources

  1. RFC 9989: DMARC

    Sections §4.4 · §5.3.5 · §5.4 · §7.4 · §8

  2. RFC 7208: SPF

    Sections §2.4 · §4.5 · §4.6.4

  3. RFC 6376: DKIM

    Sections §3.4 · §3.5 · §3.7 · §6.1 · §6.3

[ Glossary ]

Glossary

Aligned authentication
A passing SPF or DKIM identity that meets the applicable relationship to the visible From domain.
Authoritative DNS
The DNS service responsible for publishing records for a zone.
Evidence boundary
The scope of what the cited documentation or a particular test can establish.

Enterprise provenance

Why top financial institutions and governments retired their email security dashboards.

Traditional email authentication platforms sell you a dashboard and ask your engineers to do the labour. In high-stakes environments, manual oversight means delayed enforcement, configuration drift and unmonitored shadow domains.

EmailAuth is the agentic email provenance platform. Our agents enforce p=reject, keep third-party senders aligned and move your domains to full RFC 9989 compliance, the new DMARC standard,, with human-in-the-loop auditability.

Governments Large enterprises Tier-1 financial institutions

SaaS · Dedicated tenancy · Air-gapped on-prem · BYOK encryption

Knowledge Base