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.
Transactional API, 100,000 emails/month · Typical migration: About a day of code, 1–2 weeks of cutover
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.
| What | Status | Detail |
|---|---|---|
| Suppressions | Transfers | API only: SparkPost /api/v1/suppression-list per subaccount, or Bird /v1/email/suppressions. Import into Bluey first. |
| API calls | Rebuild | Replace /api/v1/transmissions (or Bird’s /v1/email/messages) with Bluey’s REST API. |
| SMTP credentials | Rebuild | Replace smtp.sparkpostmail.com or Bird’s SMTP host with Bluey’s. |
| Stored templates | Rebuild | SparkPost and Bird templates use their own syntax. Recreate them, or render in your app. |
| Webhooks | Rebuild | Map delivery, bounce, spam_complaint and unsubscribe events to Bluey’s webhooks. |
| Event history | Partial | SparkPost keeps 10 days of events, Bird 30 days of messages. Page through the API to keep any. |
| Subaccounts | Partial | Bluey Pro has subuser management; Essentials does not. |
The migration plan, in order
- 1Day 1 — before any sendAuthenticate 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.
- 2Day 1Pull 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.
- 3Day 2Put 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.
- 4Week 1–2Shift 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.
- 5Week 2Re-point webhooksMap your bounce, complaint and delivery handlers to Bluey’s event webhooks and test each one before the final switch.
- 6Week 3Remove 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.
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.
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.