Unblock Contact

Unblock a previously blocked contact.

POST
https://api.wawp.net/v2/contacts/unblock?access_token=123456789&contactId=123456789%40c.us&instance_id=123456789

Authentication Required

Login to swap the placeholders with your real Instance ID and Access Token.

Log In
Test /v2/contacts/unblock endpoint
POST
POST

No query parameters required

This endpoint doesn't expect data in the URL.

Best practices

  • Unblock users after they complete a verification or appeal process.

  • Send a message confirming the unblock to re-engage.

Restoring Connections: Unblocking Contacts

The /v2/contacts/unblock endpoint reverses the effects of a block, allowing a user to communicate with your bot again.


🔓 The "Clean Slate" Myth

It is crucial to understand what unblocking does and does not do.

What it DOES:

  1. Incoming Messages: The user can now send you messages again. You will receive them via webhook.
  2. Status: They can now see your "Online" status, "About", and Profile Picture (subject to your privacy settings).
  3. Calls: If you support VoIP, they can now call you.

What it DOES NOT:

  1. Retrieve Missed Messages: If the user sent you 50 messages while they were blocked, those messages are gone forever. They were dropped by the WhatsApp server. You cannot "fetch" them after unblocking.
  2. Notify the User: The user does not get a notification saying "You have been unblocked". They will simply notice that their messages start getting double ticks (Delivered) again.

⏳ Privacy Latency

When you unblock a user, it might take a few seconds (or up to a minute) for their app to realize they can see your Profile Picture again.

  • Reason: Their phone has cached the "blocked" state.
  • Fix: You cannot force their phone to refresh. It happens automatically.

🔄 Re-Engagement Strategies

If you blocked a user for spamming and now want to welcome them back:

1. The "Silent Unblock"

  • Action: Call unblockContact. Do nothing else.
  • Outcome: If they ever message you again, you will reply. If they don't, the conversation stays dead.

2. The "active Re-Engagement"

  • Action: Call unblockContact.
  • Action: Wait 2 seconds.
  • Action: Send a text message: "Hello! We have reactivated your account. Please follow our terms of service."
  • Outcome: Proactively brings them back into the funnel.

⚠️ Common Errors

400 Bad Request

  • Scenario: Trying to unblock a user who is not blocked.
  • Fix: Check your database status before calling this, or just wrap it in a try/catch block and ignore the error (idempotent approach).

404 User Not Found

  • Scenario: The user deleted their WhatsApp account while they were blocked.
  • Fix: Remove them from your CRM.

Request Parameters

Configure the parameters required to interact with this endpoint. All query and body arguments are listed below with their details.

Query Parameters & Request Body

Supported in URL Query String or JSON Body
string

Your unique WhatsApp Instance ID

Example:
string

Your API Access Token

Example:
string

The unique ID of the contact to unblock

Example:

Build with AI using Wawp MCP

MCP READY

Connect Wawp API directly to Cursor, Windsurf, or Claude Desktop. Let AI write, test, and execute your WhatsApp integration code automatically!

How to Connect

Request Samples

Use these ready-to-go code snippets to integrate our API into your project quickly and efficiently. Choose your preferred language and library.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/contacts/unblock";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "123456789"
6}).toString();
7const body = {
8 "contactId": "123456789@c.us"
9};
10
11fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
12 method: "POST",
13 headers: { "Content-Type": "application/json" },
14 body: JSON.stringify(body)
15})
16 .then(async (response) => {
17 if (response.ok) {
18 const data = await response.json();
19 console.log("Success:", data);
20 return data;
21 }
22
23 // Error Handling
24 if (response.status === 401) {
25 console.error("Error 401: Unauthorized - Invalid or Missing Access Token");
26 }
27 if (response.status === 400) {
28 console.error("Error 400: Bad Request - Invalid Parameter Format");
29 }
30 if (response.status === 500) {
31 console.error("Error 500: Internal Server Error - Unexpected Failure");
32 }
33
34 const errorText = await response.text();
35 console.error(`Error ${response.status}: ${errorText}`);
36 })
37 .catch((error) => console.error("Network Error:", error));
Interactive Samples
Ln 37, Col 1javascript

Expected Responses

Explore all possible responses and outcomes from the server. We have documented each status code with data examples to make success and error handling easier.

Contact unblocked successfully
application/json
boolean *

Example

{
"ok": true
}
Bad Request - Invalid Parameter Format
Unauthorized - Invalid or Missing Access Token
Internal Server Error - Unexpected Failure
Previous TopicBlock Contact
Next TopicCreate/Update Contact

Command Palette

Search for a command to run...