Migration guide

Moving anyway? Move once, to simple tiers.

SparkPost is now Bird Email, and Bird says SparkPost IDs and credentials do not work there. If you have to change your integration anyway, this is the guide to changing it once.

On SparkPost~$40/mo
On Bluey$14.95/mo

Transactional API, 100,000 emails/month · Typical migration: About a day of code, 1–2 weeks of cutover

In short

If you are still on SparkPost’s API, Bird’s own migration guide says your SparkPost IDs and credentials will not work in Bird, so a code change is coming either way. Moving to Bluey takes about a day of code changes and one to two weeks of staged cutover. Export suppressions through the API — GET /api/v1/suppression-list on SparkPost (once per subaccount) or GET /v1/email/suppressions on Bird; neither has a CSV button. Recreate stored templates, re-point webhooks, and pull any events you need first: SparkPost’s Events API keeps 10 days. At 100,000 emails a month, Bird’s Startup rate works out to about $40; Bluey Email API Essentials is $14.95.

What transfers, and what you rebuild

Stated up front, because finding out mid-migration is how a two-day job becomes a two-week one.

WhatStatusDetail
SuppressionsTransfersAPI only: SparkPost /api/v1/suppression-list per subaccount, or Bird /v1/email/suppressions. Import into Bluey first.
API callsRebuildReplace /api/v1/transmissions (or Bird’s /v1/email/messages) with Bluey’s REST API.
SMTP credentialsRebuildReplace smtp.sparkpostmail.com or Bird’s SMTP host with Bluey’s.
Stored templatesRebuildSparkPost and Bird templates use their own syntax. Recreate them, or render in your app.
WebhooksRebuildMap delivery, bounce, spam_complaint and unsubscribe events to Bluey’s webhooks.
Event historyPartialSparkPost keeps 10 days of events, Bird 30 days of messages. Page through the API to keep any.
SubaccountsPartialBluey Pro has subuser management; Essentials does not.

The migration plan, in order

  1. 1Day 1 — before any send
    Authenticate your sending domainPublish SPF, DKIM and, if you use one, DMARC records for the domain you will send from. Gmail and Yahoo have required authentication and one-click unsubscribe from bulk senders since February 2024, and an unauthenticated first send from a new platform is the fastest route to the spam folder. This is a DNS change and takes about fifteen minutes; allow up to a few hours for propagation.
  2. 2Day 1
    Pull suppressions from whichever API you send throughIf you are on SparkPost, page through the suppression list once per subaccount using the X-MSYS-SUBACCOUNT header. If you already moved to Bird, use its suppressions endpoint — it returns one record per reason, so de-duplicate addresses before importing into Bluey.
  3. 3Day 2
    Put the provider behind a switch in your codeWrap the send call so the provider is chosen by configuration, not hard-coded. That lets you route a small share of traffic to Bluey, compare, and roll back in seconds if anything looks wrong — without a deploy.
  4. 4Week 1–2
    Shift traffic in stagesSend 5–10% of transactional mail through Bluey for a few days, watch delivery and bounce rates in the activity log, then move to half and finally all of it. Keep the old provider live until a full week passes with nothing routed to it.
  5. 5Week 2
    Re-point webhooksMap your bounce, complaint and delivery handlers to Bluey’s event webhooks and test each one before the final switch.
  6. 6Week 3
    Remove SparkPost's DNS records lastOnly once nothing has been sent through SparkPost for a week, delete its DKIM, return-path and tracking records. Removing them earlier breaks authentication on any message still in flight or retried from a queue.

Mistakes people make leaving SparkPost

Each of these is recoverable, and each is much cheaper to avoid than to fix.

Exporting from the wrong accountSome teams have a legacy SparkPost account and a new Bird workspace. Bird workspace keys cannot switch tenants with X-MSYS-SUBACCOUNT, so export from the system that has actually been sending your mail.
Missing subaccount suppressionsSparkPost suppressions are held per subaccount. One export from the primary account leaves every subaccount’s bounces and complaints behind.
Letting the event window closeSparkPost’s Events API retains 10 days. If you need delivery evidence for disputes or audits, pull it before you stop sending.

Migration FAQ

What does the Bluey Email API include?

SMTP and a REST API, SPF and DKIM domain authentication, suppression management, analytics and inbound parse. Essentials has 2 event webhooks, 5 API keys and 3 days of searchable activity; Pro adds 5 webhooks, unlimited API keys, subusers and 7 days of activity. A dedicated IP is an add-on on both.

Do I have to change code to move from SparkPost to Bird?

Yes, according to Bird: SparkPost IDs and credentials do not work in Bird, and the send endpoint, auth header and webhook event names all change. If you are changing your integration anyway, it is a natural moment to compare providers.

How much will I save?

Bird’s Startup plan is a $15 monthly deposit at $0.40 per 1,000 emails, so 100,000 emails is about $40 (checked 19 November 2026). Bluey Email API Essentials is $14.95 for 100,000.

Free · 7 days

Run both in parallel. Then decide.

Seven days of full access, no credit card. Import a segment, send from Bluey while SparkPost handles the rest, and compare delivery and cost on your own data before you move the domain.