Bird (MessageBird) API

Commercial

by Bird

Omnichannel messaging API (SMS, WhatsApp, email, voice) from the company formerly known as MessageBird, with SG SMS routes and sender ID support. Alternative CPaaS to Twilio with channel-agnostic message objects.

How to authenticate

  1. 1Create a Bird account at bird.com.
  2. 2Create an access key in the dashboard (Settings > Access keys).
  3. 3Set up a channel (e.g. SMS) to get a channel id.
  4. 4Send Authorization: Bearer ACCESS_KEY (new Bird API) on requests.
  5. 5Register SG sender IDs per SGNIC rules through their compliance flow.

Example request

Request
curl -X POST 'https://api.bird.com/workspaces/WORKSPACE_ID/channels/CHANNEL_ID/messages' -H 'Authorization: Bearer ACCESS_KEY' -H 'Content-Type: application/json' -d '{"receiver":{"contacts":[{"identifierValue":"+65XXXXXXXX"}]},"body":{"type":"text","text":{"text":"Hello"}}}'

Example response

Response (truncated)
{"id":"a1b2c3...","status":"accepted","body":{"type":"text","text":{"text":"Hello"}}}

Notes for AI agents

Two API generations exist: legacy rest.messagebird.com (AccessKey header) and the new api.bird.com workspace model; new projects should use the latter. Same SGNIC sender-ID registration rule applies as Twilio.

Machine-readable version: /api/apis/bird-messagebird

Related APIs