Use this method to delete a whitelist.
Field | Type | Required | Description |
method | String | Yes | "removeFromWhitelist" |
app_id | String | Yes | Unique identifier for the App to which the user belongs. |
signups | Yes | Add an array of signups. | |
reference | String | Yes | A unique reference for the request (used for tracking or logging). |
Preconditions for API Functionality
The following tables outline the preconditions that must be met for the API to function correctly. Failure to meet these conditions may result in errors or unexpected behavior.
- Preconditions for API permissions
Before performing signup management messages, ensure the following conditions are met:
Action | Required Permission | Description |
signup Management | "Signup Management" | The API must have the "Signup Management" permission to manage both whitelist and blacklist settings. |
- Preconditions for Web Admin of Your App
Before performing signup whitelist management messages, ensure the following conditions are met:
Action | Description |
Enable "User Whitelist" | Activate the "Use Whitelist" flag from Web Admin/Signup Settings/Signup Filter to enforce whitelist filtering. |
If you add the same user to the blacklist and whitelist, the priority goes to the blacklist.
This feature is limited to apps created using the nandbox app builder.
Response
removeFromWhitelist_ack
â
On success, the
removeFromWhitelist_ack method is returned, including an echo of the signup record.Field | Type | Returned | Description |
method | String | Yes | "removeFromWhitelist_ack " |
app_id | String | Yes | Unique identifier for App. |
signups | Yes | Array of Whitelist signup objects | |
reference | String | Optional | Unique identifier echoed from the request. |
Example Requests
json{ "method": "removeFromWhitelist", "app_id": "90090684293000559", "signups": ["name@example.com"], "reference": 111111148, }
javaArrayList<String> users = new ArrayList<>(); users.add("111133"); api.deleteWhiteList(incomingMsg.getChat().getId(), users); public void deleteWhiteList(String chatId, List<String> users) { DeleteWhiteListOutMessage deleteWhiteListOutMessage = new DeleteWhiteListOutMessage(); deleteWhiteListOutMessage.setChatId(chatId); deleteWhiteListOutMessage.setUsers(users); api.send(deleteWhiteListOutMessage); }
javascriptlet users = []; users.push("111133"); api.deleteWhiteList(incomingMsg.getChat().getId(), users);
Response
json{ "method": "removeFromWhitelist_ack", "app_id": "90090684293000559", "users": [ "name@example.com" ], "reference": 111111148 }