Delete suppression list entry

Purpose

This API removes email addresses or domains from the suppression list.

Request URL

Method : DELETE

https://api.zeptomail.com/v1.1/suppressions/{zem_dnd_type}

OAuth scope

The steps to generate and use OAuth token can be found here.

scope=Zeptomail.Suppressions.All

or

scope=Zeptomail.Suppressions.DELETE

 

ALL -This gives full CRUD (Create, Read, Update and Delete) access to all suppression APIs.

DELETE - This allows access to perform the DELETE operation alone.

Path parameters

ParameterTypeDescription
zem_dnd_typeEmail/Domain

Defines the type of suppression data to be deleted — whether email or domain.

 

For example, to delete an email address from the list, replace the parameter(zem_dnd_type) with "email" in the request URL. 

Request Body 

  • values* Array
    • The email address or domain to be deleted.

Note:

* - Mandatory parameter

 

Failure response parameter

ValueErrorSolution
DND_102Suppression data not foundEnsure you have entered the correct value before proceeding.

 

Sample request

Copiedcurl "https://api.zeptomail.in/v1.1/suppressions/{email}"
-X DELETE
-H "Authorization : Zoho-oauthtoken ***"\
-H "Content-Type : application/json" \
{

{
    "values":["rebecc@zilker.com"]
}

Success code

Copied204

Failure response

Copied{
    "error": {
        "code": "DND_102",
        "field": "values",
        "message": "Suppression data not found",
        "value": "[rebecca@zilker.com]"
    },
    "status": "failure"
}