Update the status and configuration of a WhatsApp Business Account phone number. This endpoint supports comprehensive phone number management including status updates, webhook configuration, security settings, and business profile management.

Supported Operations:

• Update connection status between WhatsApp Business Account and phone number
• Configure webhook endpoints for message delivery notifications
• Set up two-step verification and security notifications
• Update display names for name verification
• Configure search visibility and privacy settings
• Set username for the WhatsApp Business Account
• Override webhook callback URIs for message notifications

Business Logic Requirements:

• App must be linked to the WhatsApp Business Account
• Webhook subscription must exist before configuring callback URI overrides
• Callback URI verification is performed for external URLs
• Internal URLs are allowed for development environments

Rate Limiting: WhatsApp use case throttling applies. Use appropriate retry logic with exponential backoff.

Security Validations:

• App-to-WABA linking validation enforced
• Webhook callback URI verification required for external URLs
• Business integration system user checks for AI bot onboarding
• Capability checks for first-party app access

{
  "connection_status": "CONNECTED",
  "webhook_url": "https://your-domain.com/webhook",
  "whatsapp_business_api_data": {
    "pin": "123456",
    "show_security_notifications": true
  },
  "pin": "123456",
  "search_visibility": "VISIBLE",
  "webhook_configuration": {
    "override_callback_uri": "https://your-domain.com/webhook/override",
    "verify_token": "YOUR_VERIFY_TOKEN"
  },
  "new_display_name": "My Business Name",
  "username": "mybusiness"
}

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+1234567890",
      "wa_id": "1234567890"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY3NzE4NDM4NjAVAgARGBI5QTRCMEM4RjA2NzY4RTlBNAA="
    }
  ]
}