API limits and error codes

Know how many calls you can make and what each error means.

1. 1

   Know the speed limit

   Each key can make 60 calls a minute. Your business also has a daily number of API calls, which is higher on Max than on Pro. The day resets at midnight Malaysia time.

2. 2

   Handle 429

   429 means you went over a limit. The message says whether it is the per-minute or the daily limit. Wait and try again, or slow your app down.

3. 3

   Handle sign-in errors

   401 means the key is missing, wrong or revoked. 403 means the key is read-only for a write call, the API is not in your plan, the business is not active, or a plan limit (like contacts) is full.

4. 4

   Handle request errors

   400 means the body is wrong or missing a field (the message says which). 404 means the endpoint or the contact/order was not found. 409 means a message could not be sent, usually because the 24-hour window is closed. 500 is a problem on our side; try again later.