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.

Billing: Request; paid actions are priced in credits (see GET /v1/messaging/prices) · Rate limit: 60/min

post/v1/messaging/whatsapp/block-users

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/messaging/whatsapp/block-users
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Request body

usersstring[] required

Phone numbers (E.164, e.g. "+16505551234") or WhatsApp user IDs to block.

accountIdstring required

WhatsApp account ID

Response

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.