Delete Suppression List

This API allows you to remove the recipients from the suppression list.

Request Type

  • DELETE

Request URL

https://campaigns.zoho.com/emailapi/v1/recipients/suppression

Content-Type

application/json

List of Request Body Attributes

ParametersData TypeDescription
recipients*JSON Array

Recipient list (in the body of the request)

➤ address* - Email address

List of Response Body Attributes

ParametersData TypeDescription
responseJSON ObjectContains the response details of the API.
codeIntegerSuccess or failure code.
messageStringSuccess or failure message returned by the API.
errorsJSON ObjectContains the error details of the API such as 'code' and 'message'.
suppressions_ignoredJSON ArrayLists the recipients who were ignored from being deleted.
suppressions_deletedJSON ArrayLists the recipients who were deleted from the suppression list.

Possible Errors

Error CodeDescription
400402Suppression list not provided.
400404Limit for a single API request has been exceeded.
400405No contacts provided in suppression list.

Sample Request Payload

Copied{
  "recipients": [
    {
      "address": "patricia@zylker.com"
    },
    {
      "address": "pamela@zylker.com"
    }
  ]
}

Sample Response - Success

Copied{
  "response": {
    "code": 200403,
    "message": "Suppressions deleted successfully"
  },
  "suppressions_ignored": [
    "pamela@zylker.com"
  ],
  "suppressions_deleted": [
    "patricia@zylker.com"
  ]
}

Sample Response - Failure

Copied{
  "errors": [
    {
      "code": 500401,
      "message": "An error occurred in Suppression List API"
    }
  ]
}