When sending messages via the Meta Cloud API, you may encounter error codes. This reference lists the most common ones and their solutions.

Authentication Errors

  • Error 190 – Invalid OAuth access token: Your access token has expired or is invalid. Regenerate it via System User in Meta Business Manager.
  • Error 200 – Permissions error: Your app lacks the required permissions. Check that whatsapp_business_messaging is approved.

Messaging Errors

  • Error 131026 – Message undeliverable: The recipient's number is not a valid WhatsApp account or they have blocked you.
  • Error 131047 – Re-engagement message: You are trying to send a free-form message outside the 24-hour window. Use a pre-approved template instead.
  • Error 131051 – Unsupported message type: The media type you are sending is not supported. Check allowed formats (image: JPEG/PNG, video: MP4, document: PDF).

Rate Limit Errors

  • Error 4 – Application request limit reached: You have hit your API rate limit. Reduce the frequency of API calls or apply for a higher tier.
  • Error 80007 – Rate limit issues: Slow down message sends. Implement exponential backoff in your automation sequences.
💡 Pro Tip: Most rate limit errors can be avoided by spreading bulk broadcasts over time rather than sending thousands of messages simultaneously.