messagebird

library2.2.0pypypi✓ verified 25d ago

MessageBird rebranded as Bird in February 2024. The old messagebird PyPI package (last version 2.2.0, released 2022) is no longer maintained and targets the legacy API. The new Python SDK is bird-python on PyPI, targeting the Bird API at docs.bird.com. LLMs almost universally generate the old package name.

communication

pip install messagebird

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MESSAGEBIRD

messagebird

communicationpythonv2.2.0

Install

2.6s avg

Import

—

Disk

45MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.2.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.000s · 70.1MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 2.6s · import 0.000s · 23MB

45MB installed

● package 45MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

messagebird.Client

✓ # New Bird SDK (post-rebrand 2024): import messagebird # import name still messagebird inside bird-python client = messagebird.Client('YOUR_ACCESS_KEY') # Legacy API (still works against old rest.messagebird.com): import messagebird client = messagebird.Client('YOUR_ACCESS_KEY') msg = client.message_create('+31612345678', ['+14155551234'], 'Hello!')

✗ # pip install messagebird pulls the unmaintained 2.2.0 package # targeting the old API — new Bird features (workspaces, channels, WhatsApp) # are not available

The import name messagebird is used in BOTH the old and new SDKs. The difference is which PyPI package you install: messagebird (old, dead) vs bird-python (new, active). The new Bird API has a completely different structure with workspaces and channels.

New Bird SDK pattern. Requires workspace and channel selection before sending.

# Install: pip install bird-python import messagebird # import name unchanged in bird-python client = messagebird.Client('YOUR_ACCESS_KEY') try: # New Bird API — workspace + channel based client.workspaces = client.workspace_list()['results'][0]['id'] channel_id = client.channel_list()['results'][0]['id'] response = client.send_message( channels_id=channel_id, body={ 'receiver': { 'contacts': [{'identifierValue': '+14155551234'}] }, 'body': { 'type': 'text', 'text': {'text': 'Hello from Bird!'} } } ) except messagebird.client.ErrorException as e: for error in e.errors: print(error.description)

Debug

Known issues

breakingMessageBird rebranded as Bird in February 2024. The messagebird PyPI package (2.2.0) is unmaintained and targets the legacy API. New features (workspaces, channels, WhatsApp via Bird API) are only available in the bird-python package.

fix

pip uninstall messagebird && pip install bird-python. Update API documentation reference from developers.messagebird.com to docs.bird.com.

affects: all

breakingThe new Bird API has a completely different message-sending model. Instead of client.message_create(src, dst, text), it uses workspace + channel selection followed by client.send_message(channels_id, body). All old code patterns break.

fix

Set workspace: client.workspaces = client.workspace_list()['results'][0]['id']. Get channel ID: client.channel_list(). Then send with the new body format.

affects: bird-python (new API)

gotchaBoth the old messagebird package and the new bird-python package use import messagebird as the import statement. This makes it impossible to tell from the import line alone which API version the code targets.

fix

Check which PyPI package is installed (pip show messagebird vs pip show bird-python). The new Bird API requires workspace/channel setup before sending.

affects: all

gotchaAccess keys from the old MessageBird dashboard may not work with the new Bird API. The Bird platform uses a new authentication system via manage.bird.com.

fix

Generate new API keys at manage.bird.com. Old keys from manage.messagebird.com may be valid during transition but should be rotated.

affects: bird-python

Upgrade

Version history

2.2.0latest on PyPI · released Jun 21, 2024

Audit

Dependencies

requestsrequiredRequired by both packages.

Agent activity

25 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/messagebird/python-rest-api ↗

packagehttps://pypi.org/project/messagebird/ ↗

homepagehttps://bird.com ↗