Menu

Invalid E-Mails API

An invalid email occurs when you attempt to send email to an address that is formatted in a manner that does not meet internet email format standards or the email does not exist at the recipient’s mail server.

Examples include addresses without the “@” sign or addresses that include certain special characters and/or spaces. This response can come from our own server or the recipient mail server.

For more information, please see our Invalid Email documentation.

Delete invalid emails

Delete invalid emails

DELETE /suppression/invalid_emails

This endpoint allows you to remove email addresses from your invalid email address list.

There are two options for deleting invalid email addresses:

1) You can delete all invalid email addresses by setting delete_all to true in the request body. 2) You can delete some invalid email addresses by specifying certain addresses in an array in the request body.

Authentication

  • API Key

Headers

Authorization
string
default: Bearer <<YOUR_API_KEY_HERE>>
required
on-behalf-of
string
default: The subuser's username. This header generates the API call as if the subuser account was making the call.

Request Body

object
delete_all
boolean

Indicates if you want to remove all email address from the invalid emails list.

emails
array[string]

The list of specific email addresses that you want to remove.

{
  "delete_all": false,
  "emails": [
    "example1@example.com",
    "example2@example.com"
  ]
}

Responses

object

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.