---
title: "Block users"
method: POST
path: "/v1/whatsapp/block-users"
tags: ["WhatsApp"]
---

# Block users

`POST /v1/whatsapp/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.

## Request body

- object
  - `accountId` string, required — WhatsApp social account ID
  - `users` string[], required — Phone numbers (E.164, e.g. "+16505551234") or WhatsApp user IDs to block.

## Response `200`

Per-user results

- object
  - `blocked` object[] — Users successfully blocked.
    - `input` string — The value you sent.
    - `waId` string — Resolved WhatsApp user ID.
  - `failed` object[] — Users that could not be blocked, with reasons.
    - `input` string
    - `errors` string[]

## Other responses

- `401` — Unauthorized
- `404` — WhatsApp account not found

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)