The /email/validate endpoint is designed to validate and verify email addresses. It checks the provided email against trusted external data sources and returns validation insights, such as whether the email is valid, disposable, a spam trap, or undeliverable.

Authentication

The validateEmail endpoint requires authentication via Salesforce OAuth 2.0. Requests must include a valid OAuth access token in the Authorization header.

Method Signature

POST /services/apexrest/recordval/v1/email/validate

Parameters

Type	Variable	Description
EmailValidationInput_v1	`emailInput`	The structured input object containing email fields for validation.

Example Request

{
  "emailAddress": "[email protected]",
  "note": "Validating email input"
}

Output

Return Type: EmailValidationOutput_v1.

Example Response

{
  "complete": "[email protected]",
  "addressee": "example",
  "domain": "email.com",
  "free": true,
  "disposable": false,
  "status": {
    "code": "200",
    "message": "Valid email address",
    "credit": true
  },
  "advice": "GREEN"
}