Meta API Error Codes Error 100 400 Bad Request

WhatsApp Error 100: Invalid Parameter — Payload Syntax Resolution

Error 100 is a generic invalid parameter exception indicating that a field name is misspelled, a value does not adhere to allowed enums, or required parameters are missing.

Probable Causes

  • Recipient phone number formatted with + sign or spaces (Meta requires digits only: country code + number)
  • Misspelled JSON key (e.g. recipient_types instead of recipient_type)
  • Invalid component type string in template parameters

Step-by-Step Resolution

Recommended Fix Protocol:

Strip all spaces, hyphens, and + signs from phone numbers before calling the API (e.g. 918779713123). Validate your payload JSON against official Meta Graph API v20+ schema specifications.

Technical Example / Code Payload:

// Correct Phone Number Formatting $cleanNumber = preg_replace('/[^0-9]/', '', $rawPhone); // Output: 918779713123
Quick Answers

Frequently Asked Questions

Should phone numbers include the + symbol?+

No. WhatsApp Cloud API requires country code and subscriber number with digits only (no leading + or 00).

Can I send messages to landline numbers?+

No. WhatsApp Business API only delivers to active mobile phone numbers.

Need Technical Help?

Resolve WhatsApp API Issues Fast with NY Digital

Our certified Meta API engineering team helps Indian enterprises diagnose webhook bugs, unblock banned numbers, and scale messaging limits safely.

Speak with Our Engineering Team
Chat on WhatsApp