Lists
Delete a list
DELETE
https://api.smsedge.com/v1/lists/delete/Deletes a list so it no longer shows in your account or the API.
The list is hidden, not erased. Campaign reports that used the list keep their data. You cannot restore a deleted list through the API.
Query params
idintegerrequiredID of the list to delete.
Responses
- 200The list was deleted.
- 400The id parameter is missing.
- 404No list with this ID in your account, or it is already deleted.
curl -X DELETE "https://api.smsedge.com/v1/lists/delete/?id=348120" \
-H "X-API-KEY: YOUR_API_KEY"[
{
"success": true,
"data": {
"message": "List [348120] has been deleted successfully"
},
"errors": [],
"response": {
"code": 200,
"description": "OK",
"date": "2026-11-16 14:12:40"
},
"api": {
"version": "v1",
"module": "lists",
"function": "delete"
},
"user": {
"id": 12345
}
}
]All requests need your API key in the X-API-KEY header. See Authentication.