When using the WhatsApp Business API, encountering Error Code 130429 with the error code message, "Cloud API message throughput has been reached." signals that the app has hit its current message throughput limit. This error comes with a 400 Bad Request status and happens when an app attempts to send messages faster than the API's allowed throughput. Here’s a straightforward guide to understand and manage this limit.

What Causes Error Code 130429?

Error Code 130429 is triggered when the API’s throughput limit is exceeded. Throughput is the rate at which messages can be sent per second. The Cloud API allows up to:

  • 80 messages per second (mps) by default for each registered business phone number.

  • 1,000 mps for eligible accounts that are automatically upgraded.

Throughput includes all message types, both incoming and outgoing. When you exceed this rate, the API temporarily blocks further requests.

How to Check and Manage Your Throughput

1. Check Your Throughput Level. Use the WhatsApp Business Phone Number  endpoint to check your current limit.

Copy code: 

GET /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>?fields=throughput

OR

Use the curl:

curl -X GET "https://graph.facebook.com/v17.0/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>?fields=throughput" \-H "Authorization: Bearer <ACCESS_TOKEN>"

Replace <WHATSAPP_BUSINESS_PHONE_NUMBER_ID> with your actual WhatsApp Business Phone Number ID and <ACCESS_TOKEN> with the actual access token.

2. Some accounts qualify for an automatic throughput upgrade to 1,000 messages per second (mps) at no extra cost. 

​How to Upgrade WhatsApp API Throughput

WhatsApp API throughput upgrades happen automatically when your business phone number meets the eligibility requirements. To qualify for the upgrade from 80 mps to 1,000 mps, your business phone number must meet the following criteria:

  • Your phone number must initiate conversations with an unlimited number of unique customers in a rolling 24-hour period.

  • The phone number must be registered on the Cloud API. Numbers using the On-Premises API need to migrate to the Cloud API first.

  • The phone number should have a Medium or higher quality rating.

Tips to Avoid Error Code 130429

  • Schedule non-urgent messages during off-peak hours or distribute messages evenly across the hour to avoid excessive bursts that could trigger rate limiting.

  • If you reach the limit and encounter Error Code130429, wait for some time to restore request capacity and try again later.

For more troubleshooting tips or insights on how to optimize your business using WhatsApp Business API check out our other blogs at heltar.com/blogs.