The Delete Contact commands allow you to permanently delete an existing Contact record and all subscriptions.
DELETE /subscribers
https://[siteurl]/rest/subscribers
Request Body Parameters
The Delete Contact by Email + First name command requires the Contact Email and First name defined within the submitted JSON in order to delete. No additional fields are required in the JSON. Delete cannot be undone.
Request Body Example
Using Delete Contact, line breaks in JSON for readability:
curl --request DELETE \
--url 'https://mail.mydomain.com/rest/subscribers/10' \
--header 'authorization: Basic bXlBY2NvdW50Onh5enB3ZDEyMw==' \
--header 'accept: application/vnd.whatcounts-v1+json' \
--data '{
"email": "myemail@mydomain.com",
"firstName": "myName"}' \
--include
Response Body
The response returns an HTTP status code only with no additional JSON. Based on the example above, the response returns:
HTTP/1.1 204 NO CONTENT
Server: serverName
Content-Type: application/json
Content-Length: 6
Link: <https://mail.mydomain.com/rest/subscribers>;
Date: Fri, 17 Jun 2016 12:54:44 GMT
{
}
Error Response
Error Response Codes include both Client Errors (4xx) and Server Errors (5xx). Descriptions of each can be found in Response Codes.
For example, if the List does not exist, the error would appear as:
{
"error": "Delete Failed: Unable to find resource to delete"
"status": "Not Found"
"statusCode": 404
}