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"
}Request display name change POST
Submit a display name change request for the WhatsApp Business account. The new name must follow WhatsApp naming guidelines (3-512 characters, must represent your business). Changes require Meta review and approval, which typically takes 1-3 business days.
Provision CTWA conversions dataset POST
Creates (or fetches, if one already exists) the Meta dataset that Click-to-WhatsApp ad events are reported against via the Conversions API, and persists its ID on the account as `metadata.metaCapiDatasetId`. The call is GET-first idempotent — a WABA can only own one CTWA dataset, so a second call after a successful provision is a safe no-op that returns the same ID with `created: false`. Requires the connected WhatsApp account's token to carry the `whatsapp_business_manage_events` permission. If the permission is missing the endpoint returns 422 with a message asking the user to reconnect the account.