Block users
Block one or more WhatsApp users on this number. Blocked users cannot message your number or see that you are online, and your sends to them return an error.
Meta constraints, surfaced per-user in failed (the request itself still
succeeds for the rest of the batch):
- Only users who messaged your business within the last 24 hours can be blocked (failures outside the window report "Re-engagement required").
- Up to 1,000 users per request; the blocklist caps at 64,000.
- Other WhatsApp Business accounts cannot be blocked.
API key authentication - use your Zernio API key as a Bearer token
In: header
WhatsApp social account ID
Phone numbers (E.164, e.g. "+16505551234") or WhatsApp user IDs to block.
1 <= items <= 1000Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.whatsapp.blockWhatsAppUsers({ body: { accountId: 'account_abc123', users: [ 'string', ], },});console.log(data);{
"blocked": [
{
"input": "string",
"waId": "string"
}
],
"failed": [
{
"input": "string",
"errors": [
"string"
]
}
]
}{
"error": "Unauthorized"
}List blocked users GET
List the WhatsApp users blocked on this number. Cursor-paginated; pass `nextCursor` back as `after` to fetch the next page. The blocklist holds up to 64,000 users.
Unblock users DELETE
Unblock one or more previously blocked WhatsApp users on this number. Up to 1,000 users per request; per-user failures are reported in `failed` without failing the rest of the batch.