CMSCommercial ยท Bird

Bird (MessageBird) API

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

5 stops to a working call

  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"}}}

Bird (MessageBird) API: common questions

Is the Bird (MessageBird) API free?

The Bird (MessageBird) API is listed as paid. Check the official Bird docs for current pricing.

Does the Bird (MessageBird) API need an API key?

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

What is the Bird (MessageBird) API endpoint?

The base URL is https://api.bird.com. A working example: 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"}}}'

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

On the same line