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.

Related resources

Continue with the documentation, guides and examples for this topic. Resources are in English.

Explore the capabilityWhatsAppImplementation guideSending WhatsApp messagesWatch the guideConnecting WhatsApp to Bird: from buying a number to a live channelUse the toolWhatsApp message builder
Try the practice and get an implementation brief

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