Lists

Delete a list

DELETEhttps://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

  • idintegerrequired

    ID 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.