Skip to content
Meta Business PartnerAPI error reference

WhatsApp API error 33: Parameter value is not valid

Error 33 means the business phone number your call points to no longer exists on the platform. The request usually names it by its phone number ID, and that ID now refers to a deleted number.

33
Code
Parameter value is not valid
Meta's name
Account set-up
Type
On the API response
Where you see it
After fixing the cause
Retry

Quick answer

The business phone number in the request was deleted. Use the phone number ID of a number that's still in your account.

What WhatsApp error 33 means

Meta documents code 33 as: the business phone number has been deleted, and advises verifying that the business phone number is correct.

Why error 33 happens

Account errors come from the set-up behind the number, not from the message. Check these:

  • The number was removed from the WhatsApp Business Account, and the old phone number ID is still configured.
  • A test number was deleted after the integration moved to production, but one service still uses it.
  • The number was moved to another account, which gave it a new phone number ID.
  • Configuration was copied from another environment with a different number.

How to fix error 33

Work through these in order; the first one that turns up a problem is usually the fix.

  • List the phone numbers in your WhatsApp Business Account and note each one's current phone number ID.
  • Update every service and environment that still holds the deleted ID.
  • If the number should still exist, check with the account admin whether it was removed by mistake, then add and register it again.
  • Keep phone number IDs in one configuration source rather than scattered across services.

Should you retry after 33?

Calls to a deleted number never succeed. Change the request to a number that exists, then send.

How error 33 shows up in InfiQ

If Meta rejects the send straight away, InfiQ's API answers with an HTTP error that carries Meta's own error object: error.code 33, a message beginning "(#33)" and Meta's explanation in error_data.details, plus an InfiQ_traceid. Keep the trace IDs with the failed message: they are what support needs to look it up. Through InfiQ you send from a number connected to your InfiQ account, so this code usually means the number was removed in Meta's tools after it was connected; contact support with the InfiQ_traceid.

Send it through InfiQ

Frequently asked questions

Can a deleted WhatsApp business number be restored?+
You can add the number to an account and register it again, which gives you a working number, but your configuration needs the phone number ID it has now, not the old one.
What's the difference between a phone number and a phone number ID?+
The phone number is the dialable number; the phone number ID is Meta's identifier for that number inside a WhatsApp Business Account, and it's what API calls use. Removing and re-adding a number can change the ID.
Why do I get error 33 only from one server?+
That server probably has an old phone number ID in its configuration. Compare the IDs each environment uses with the account's current list.

Get your WhatsApp account set up right

InfiQ onboards your number on the official WhatsApp Business API and helps you clear set-up errors.