Every channel you follow sends messages to your webhook. If you follow 1,000 active news channels, your server might receive 50+ messages per second. Best Practice: Periodically audit your subscriptions using /v2/channels and unfollow inactive or low-relevance channels to save bandwidth.

Unfollow Channel

Stop following a WhatsApp channel.

POST

https://api.wawp.net/v2/channels/{id}/unfollow?access_token=123456789&id=1234567890%40newsletter&instance_id=123456789

Authentication Required

Test /v2/channels/{id}/unfollow endpoint

Supports

POST

No query parameters required

This endpoint doesn't expect data in the URL.

Breaking Up: Unfollowing Channels

The /v2/channels/{id}/unfollow endpoint terminates your subscription to a channel. This is the "Cleanup" operation of the Channels lifecycle.

🛑 Why Unfollow?

1. Reducing Noise

Every channel you follow sends messages to your webhook. If you follow 1,000 active news channels, your server might receive 50+ messages per second.

Best Practice: Periodically audit your subscriptions using /v2/channels and unfollow inactive or low-relevance channels to save bandwidth.

2. Privacy & Opt-Out

If you are building a "User Proxy" service (where your users ask your bot to follow channels for them), you must provide an Unsubscribe mechanism. When a user says "Stop," you must call this endpoint to respect their choice and the channel owner's analytics.

⚙️ Technical Behavior

Webhook Cessation: The moment this call returns 200 OK, tips: [ { type: 'info', title: 'Cleanup', content: 'Removes the channel from your updates list.' }, { type: 'warning', title: 'Analytics', content: 'You will no longer receive view metrics for this channel.' } ], recommendations: [ "Ask for feedback upon unfollowing to improve your content recommendation engine.", "Confirm the action if it's accidental." ]

your instance will stop receiving message events from this JID.

History Retention: You will still retain access to the messages you already received and stored in your own database, but you may lose access to fetch historical messages from the WhatsApp server for this channel.
Idempotency: If you call this on a channel you are not following, it will likely return a success or a harmless error. It is safe to retry.

⚠️ The "Zombie" State

In rare cases, if you unfollow a channel but still have it cached locally in your app as "Active," you might try to send reactions/messages to it. These will fail with 403 Forbidden.

Action: Always update your local "Inventory" immediately after calling this endpoint.

Request Parameters

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

Request Body

Sent as a JSON object

	`string`		Your unique WhatsApp Instance ID Example:
	`string`		Your API Access Token Example:
	`string`		The unique ID of the channel Example:

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/channels/1234567890@newsletter/unfollow";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7
8
9fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
10  method: "POST",
11  headers: { "Content-Type": "application/json" },
12  
13})
14  .then(async (response) => {
15    if (response.ok) {
16      const data = await response.json();
17      console.log("Success:", data);
18      return data;
19    }
20    
21    // Error Handling
22    if (response.status === 401) {
23      console.error("Error 401: Unauthorized - Invalid or Missing Access Token");
24    }
25    if (response.status === 500) {
26      console.error("Error 500: Internal Server Error - Unexpected Failure");
27    }
28
29    const errorText = await response.text();
30    console.error(`Error ${response.status}: ${errorText}`);
31  })
32  .catch((error) => console.error("Network Error:", error));

Interactive SamplesUTF-8

Ln 32, 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.

Unfollowed channel successfully

application/json

string *

Example

{
"status": "success",
"message": "No longer following the channel"
}

Unauthorized - Invalid or Missing Access Token

Internal Server Error - Unexpected Failure