- Anti-Spam (60s Cooldown): To prevent abuse, each recipient can only receive one authentication request every 60 seconds. - Universal Auth: Supports Bearer tokens in Headers, Query parameters, or JSON Body. - Engine Compatible: Automatically wraps payloads for different engines. - Subscription Aware: Unlimited users b

Send Auth List

Send an interactive WhatsApp list message for authentication. Supports JSON Body, Query, and Headers.

POST

https://api.wawp.net/v2/auth/list/send?access_token=YOUR_TOKEN&button=Verify+Identity&chatId=201XXXXXXXXX&description=Please+confirm+your+login+attempt.&footer=Wawp+Security&instance_id=YOUR_INSTANCE&item1=Yes%2C+it+is+me&item2=No%2C+Reject&title=%F0%9F%94%90+Login+Confirmation

Authentication Required

Test /v2/auth/list/send endpoint

Supports

POSTGET

No query parameters required

This endpoint doesn't expect data in the URL.

Header Support

You can put your token in the 'Authorization: Bearer ...' header to keep your URLs clean.

Interactive WhatsApp Authentication

This endpoint is now Universal. You can provide credentials via Headers, Body, or Query parameters.

🚀 Key Features

Anti-Spam (60s Cooldown): To prevent abuse, each recipient can only receive one authentication request every 60 seconds.
Universal Auth: Supports Bearer tokens in Headers, Query parameters, or JSON Body.
Engine Compatible: Automatically wraps payloads for different engines.
Subscription Aware: Unlimited users bypass queues and benefit from Sync Sending (Immediate delivery).

🛡️ Usage Example (JSON Body)

{ "instance_id": "YOUR_INSTANCE", "access_token": "YOUR_TOKEN", "chatId": "201XXXXXXXXX", "title": "Login Confirmation", "item1": "Yes, it is me", "item2": "No, Reject" }

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`		The instance ID to send from. Example:
	`string`		Your API access token. Example:
	`string`		Recipient WhatsApp number. Example:
	`string`		Main title displayed at the top of the list. Example:
	`string`		Title for the FIRST option (Approve). Example:
	`string`		Title for the SECOND option (Reject). Example:
	`string`		Button text that opens the list. Example:
	`string`		Sub-text below the title. Example:
	`string`		Footer text. 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/auth/list/send";
3const params = new URLSearchParams({
4  "instance_id": "YOUR_INSTANCE",
5  "access_token": "YOUR_TOKEN"
6}).toString();
7const body = {
8  "chatId": "201XXXXXXXXX",
9  "title": "🔐 Login Confirmation",
10  "item1": "Yes, it is me",
11  "item2": "No, Reject",
12  "button": "Verify Identity",
13  "description": "Please confirm your login attempt.",
14  "footer": "Wawp Security"
15};
16
17fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
18  method: "POST",
19  headers: { "Content-Type": "application/json" },
20  body: JSON.stringify(body)
21})
22  .then(async (response) => {
23    if (response.ok) {
24      const data = await response.json();
25      console.log("Success:", data);
26      return data;
27    }
28    
29    // Error Handling
30    if (response.status === 401) {
31      console.error("Error 401: Unauthorized - Invalid token");
32    }
33    if (response.status === 429) {
34      console.error("Error 429: Rate Limit - Recipient protection");
35    }
36
37    const errorText = await response.text();
38    console.error(`Error ${response.status}: ${errorText}`);
39  })
40  .catch((error) => console.error("Network Error:", error));

Interactive SamplesUTF-8

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

Auth list sent successfully

application/json

string *

Example

{
"code": "success",
"message": "Auth request sent.",
"auth_id": "539836",
"job_id": "245"
}

Unauthorized - Invalid token

Rate Limit - Recipient protection