Unblock Contact
Unblock a previously blocked contact.
Authentication Required
Login to swap the placeholders with your real Instance ID and Access Token.
Log InNo 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:
- Incoming Messages: The user can now send you messages again. You will receive them via webhook.
- Status: They can now see your "Online" status, "About", and Profile Picture (subject to your privacy settings).
- Calls: If you support VoIP, they can now call you.
What it DOES NOT:
- 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.
- 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/catchblock 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 Bodystring | 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 READYConnect Wawp API directly to Cursor, Windsurf, or Claude Desktop. Let AI write, test, and execute your WhatsApp integration code automatically!
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.
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.
Example
{
"ok": true
}Command Palette
Search for a command to run...