Block a contact
Adds a contact to the WhatsApp block list of the authenticated WUTS device. Provide the target as a JID or a phone number in the body or query string; WUTS resolves the LID/PN identity automatically.
Adds a contact to the WhatsApp block list of the authenticated WUTS device. Provide the target as a JID or a phone number in the body or query string; WUTS resolves the LID/PN identity automatically.
Authorization
bearerAuth Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.
In: header
Query Parameters
Target JID used as a fallback when no body is sent.
Target phone number used as a fallback when no body is sent.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Identifies the contact to block or unblock. Supply a jid or a number; both default to the matching query parameter when omitted.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/contacts/block" \ -H "Content-Type: application/json" \ -d '{ "jid": "5511999999999@s.whatsapp.net" }'{ "success": true, "data": { "jid": "5511999999999@s.whatsapp.net", "phone_number": "5511999999999", "action": "block", "blocked": true, "count": 3, "dhash": "2:abc123def456" }}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}Sync app state scopes POST
Forces the WUTS device to fetch fresh WhatsApp app-state patches for the requested scopes (contacts, chats, settings, pins, critical). When no scopes are provided, contacts, chats, and settings are synced. The body is optional.
Check if numbers have WhatsApp POST
Checks a batch of phone numbers against WhatsApp and returns a map of cleaned number to a boolean indicating whether each number is registered. Numbers are normalized (plus, dashes, spaces, and parentheses stripped) before lookup.