Contacts

Unblock a contact

Removes a contact from 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.

POST
/contacts/unblock

Removes a contact from 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.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Query Parameters

jid?string

Target JID used as a fallback when no body is sent.

number?string

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/unblock" \  -H "Content-Type: application/json" \  -d '{    "number": "5511999999999"  }'
{  "success": true,  "data": {    "jid": "5511999999999@s.whatsapp.net",    "phone_number": "5511999999999",    "action": "unblock",    "blocked": false,    "count": 2,    "dhash": "2:def456abc789"  }}
{  "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"}