Block Users API guide | Developer Documentation

The Block Users API enables your business to block bad actors from contacting you.

When you block a WhatsApp user, the following happens:

Errors on the API occur per-number since blocks might succeed on some numbers and fail on others.

The Block Users API is synchronous.

The API contains three endpoints:

Code	Description
139100 Failed to block/unblock some users	Bulk blocking failed to block some or all of the users.
139101 Blocklist limit reached	The blocklist has reached its 64,000 user limit.
139102 Blocklist concurrent update	Occurs when the blocklist is updated while performing a pagination request and version_id does not match.
139103 Internal error	Internal error, please try again.
130429 Rate Limit Hit	Occurs when either: Too many numbers are in the request itself.Or, too many requests are made over a short period of time.
131021 Self Block	Failed to block self phone number.
131047 Re-engagement required	Occurs if the business has not received a message from that number in the last 24 hours. This error will also be returned if the number is an invalid WhatsApp user.