Migration guide

How to migrate from IDM interactive digital media to Bird

A developer's guide to migrating from IDM interactive digital media to Bird: channel changes, request-format mapping, a step-by-step checklist, and data-backed gotchas.

IDM interactive digital media is a German CPaaS provider offering SMS, voice, and multichannel A2P messaging from data centers in Germany. Bird (formerly MessageBird) is a communications infrastructure platform providing unified APIs for email, SMS, WhatsApp, and voice. On the messaging.dev Score, IDM interactive digital media rates 47/100 and Bird 76/100; this guide covers what actually changes at the API level when you move.

What changes when you move

Channels. Both providers support SMS, WhatsApp, and voice, so your core traffic carries over. You gain email — Bird has a native email product; IDM does not. You lose Facebook Messenger and Telegram, both of which IDM supports and Bird does not, so plan replacements before cutover if you route traffic over them today. Neither provider offers MMS, RCS, Viber, or Apple Messages for Business.

Compliance and residency. Both are GDPR-compliant and ISO 27001 certified. Bird additionally holds SOC 2 and HIPAA. On residency, IDM hosts exclusively on EU (German) servers with no region choice; Bird runs both EU and US regions and lets you choose where data lives.

Pricing and credit. IDM prices volume-based per message, primarily through custom enterprise quotes with no public price list. Bird publishes usage-based rates with no platform or seat fees (SMS from $0.0073 per US message) and includes a free email tier (1,000/month). IDM offers no free developer credit.

Tooling. IDM ships no official SDKs and has no sandbox; its docs are rated medium. Bird ships TypeScript, Python, and Go SDKs, offers a sandbox, and its docs are rated high. IDM also exposes SMPP alongside REST; Bird’s second protocol is SMTP (for email), not SMPP.

How the request format differs

Source (IDM interactive digital media):

curl -X POST https://api.i-digital-m.com/v2/sms/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+4915123456789",
    "from": "IDM",
    "text": "Your order is ready to ship. Tracking: XY123456"
  }'

Target (Bird):

curl -X POST "https://us1.platform.bird.com/v1/sms/messages" \
  -H "Authorization: Bearer bk_us1_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155550100",
    "from": "Bird",
    "text": "Your Bird verification code is 481920. It expires in 10 minutes.",
    "category": "authentication"
  }'

Three things change. Endpoint: IDM posts to https://api.i-digital-m.com/v2/sms/send; Bird posts to a region-prefixed host, https://us1.platform.bird.com/v1/sms/messages (use eu1 for the EU region). Authentication: both pass a Bearer token, but IDM issues an OAuth2 bearer token, while Bird uses a region-prefixed API key (bk_us1_... / bk_eu1_...) whose prefix encodes the regional host — the SDKs route automatically. Payload: the core fields map one-to-one — to, from, and text are named identically — so the body is nearly a drop-in. Bird adds a category field (e.g. "authentication") that classifies message intent.

Migration checklist

  1. Create a Bird account (self-onboarding) and generate a region-prefixed API key, picking the region (us1 or eu1) that matches your residency needs.
  2. Map the request fields: to, from, and text carry over unchanged; add Bird’s category where relevant.
  3. Re-point your sending code to the region host and swap the OAuth2 token for the bk_ key. Optionally adopt a Bird SDK (TypeScript, Python, or Go).
  4. Re-test against Bird’s sandbox before sending any live traffic.
  5. Update your delivery/status webhooks to consume Bird’s callback format.
  6. Run both providers in parallel and reconcile delivery reports.
  7. Cut over once Bird’s delivery metrics match, and rebuild any Facebook Messenger or Telegram flows on an alternative channel.

For a from-scratch walkthrough, see how to start with Bird; for a full side-by-side, see Bird vs IDM interactive digital media.

Watch out for

  • No Facebook Messenger or Telegram — both are IDM channels that Bird does not offer.
  • No SMPP — IDM supports SMPP binds; Bird’s non-REST protocol is SMTP only.
  • Fewer countries — Bird lists 150 countries covered versus IDM’s 180.
  • Lower documented uptime SLA — Bird cites a 99.95% legacy MessageBird SLA (current SLAs are per-service-plan), versus IDM’s stated 99.99%.