EmailOctopus logo

API > Lists > Delete List

DELETE https://emailoctopus.com/api/1.6/lists/:listId

Delete a list.

Parameters
api_key (string) Your API key.
200 (success) returns
An empty response.
Non-200 (error) returns

Details of the error:

code (string) The error code.
message (string) A description of the error.
Method-specific error codes
LIST_NOT_FOUND The list could not be found.
API-wide error codes
INVALID_PARAMETERS Parameters are missing or invalid.
API_KEY_INVALID Your API key is invalid.
UNAUTHORISED You're not authorised to perform that action.
NOT_FOUND The requested endpoint does not exist.
UNKNOWN An unknown error has occurred.
Example request
/api/1.6/lists/00000000-0000-0000-0000-000000000000?api_key=00000000-0000-0000-0000-000000000000
Example response 
                        
                            {}
Code sample
copy
curl -X DELETE https://emailoctopus.com/api/1.6/lists/00000000-0000-0000-0000-000000000000?api_key=00000000-0000-0000-0000-000000000000