List blocked users
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.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
WhatsApp social account ID
Page size.
1 <= value <= 100Cursor from a previous response's nextCursor.
Response 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.getWhatsAppBlockedUsers({ query: { accountId: 'account_abc123', },});console.log(data);{
"blockedUsers": [
{
"waId": "string"
}
],
"nextCursor": "string"
}{
"error": "Unauthorized"
}Check if a user is blocked GET
Definitive blocked-state lookup for a single contact. Meta exposes no membership endpoint, so this reads Zernio's blocklist mirror (kept in sync by the block/unblock endpoints; the first call per account backfills the mirror from Meta's full list). Constant-time regardless of blocklist size.
Block users POST
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.