POST /address/v1/validateEmail

Overview

Validates an email by specifying the email address and validators to be used in the request body of the HTTP POST. You can use more than one validator in the same call.

Usage

Example Request

Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /address/v1/validateEmail
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
  "email": "help@example.com",
  "validators": [ "SyntaxValidator", "MXValidator", "ListDetectiveValidator" ]
}

Example Response

If the email address is valid, the API returnes this response.

{
  "email": "help@example.com",
  "valid": true
}

If the email address is not valid, the API returns this response, indicating which validator failed.

{
  "email": "this@is@not@a@valid@email@address",
  "valid": false,
  "failedValidation": "SyntaxValidator"
}