What does BSUID stand for in WhatsApp?

BSUID stands for Business-Scoped User ID. It is a unique, stable identifier that WhatsApp assigns to each user for each business, used in webhook payloads when the user has enabled a username.

Is BSUID the same as a phone number?

No. A BSUID is an opaque alphanumeric string that does not reveal the user's phone number. It replaces the phone number in certain webhook fields when the user has a username enabled.

When will BSUID affect my integration?

BSUID affects your integration as soon as any of your customers enable a WhatsApp username. During the 2026 rollout, you will see a growing mix of phone numbers and BSUIDs in your webhooks.

Do I need to change how I send messages?

No. The outbound Message API still accepts phone numbers in the to field. WhatsApp resolves the identifier internally. You only need to handle BSUIDs in inbound webhooks and status callbacks.

Will BSUID break my existing conversations?

No. Existing conversations remain intact. Only new messages after the customer enables a username will carry BSUID values.

Can the same customer have different BSUIDs for different businesses?

Yes. Each business gets a different BSUID for the same customer. This is by design to prevent cross-business tracking.

What happens if I ignore BSUID?

Your webhook handlers that assume numeric wa_id values will fail when processing BSUID payloads. This can cause missed messages and incorrect customer identity mapping.

WhatsApp Business Scoped User IDs (BSUID)

The developer's hub for migrating physical IDs to scoped identities. Ensure your webhooks are ready for the global rollout.

Validate Your Webhooks

Meta is actively deprecating raw phone number routing. Use our JSON payload analyzer to ensure your backend infrastructure will process BSUID structures correctly.

Run API Audit Check

Integration Library

Technical FAQ: BSUID and WhatsApp API Breaks

Technical Q&As addressing API breaks, developer webhooks, pricing metrics, and token configurations for enterprise integrations.

The BSUID Integration Checklist for Developers

A copy-pasteable checklist mapping out code migration patterns, webhook payload adaptations, and troubleshooting steps.

BSUID Migration Timeline: The 2026 Roadmap

A chronological timeline of Meta's global username and BSUID migration rollouts for enterprise developers.

What is a WhatsApp BSUID? Engineering Deep Dive

Clarifying WhatsApp Business Scoped User IDs (BSUIDs), user payload structure parameters, and security isolation layers.