Changelog · back to all

WhatsApp messages now support tags and metadata

feature

The WhatsApp messaging API brings tags and metadata in line with the rest of the platform. When you send a WhatsApp message, you can now attach:

  • Tags: structured {name, value} labels, up to 20 per send, for low-cardinality dimensions like category or experiment_variant
  • Metadata: an arbitrary JSON object (up to 2 KB) for your own per-send context, such as internal IDs

Both are echoed back on the message resource and on list results, which also gain a tag query parameter to filter by tag name or an exact name:value pair, matching the filtering already available for email and SMS messages.

Start with one channel.
Add the others when you're ready.

A test API key is yours immediately. Production unlocks when you add a payment method and verify a sender.

Get startedRead docs

Using Claude Code, Cursor, or Codex? Copy a setup prompt and your agent installs the Bird CLI and skills for you. Pick yours:

Cursor