<commit_before>---
layout: page
weight: 55
title: Email Address Validation
group: managing-contacts
navigation:
  show: true
seo:
  title: Email Address Validation
  keywords: email, validation, signup
  override: true
  description: Twilio SendGrid's real-time Email Address Validation provides you detailed information on the validity of your users' email addresses, as well as allows you to integrate this validation process into your signup process. 

---
Email Address Validation provides real-time detailed information on the validity of email addresses. You can integrate this validation process into your platform's signup form and customize the best use of email address validation for your use case: - Identify a validation threshold from which you feel comfortable sending a follow up email
- Display to your form visitors that their email addresses are likely invalid within your form
- Decide if you want to drop invalid email addresses from your database.

Validating email addresses allows you to to suppress invalid email addresses from your sending, decreasing your bounce rate, cleaning your subscriber list, ultimately improving your sender reputation.

Email Validation Beta is free for Pro and Premier plans while in Beta. Once Email Validation moves out of Beta, it will incur a usage charge. 

## Generating your Email Validation API Key

Before you can call the Email Address Validation Real Time API endpoint, you’ll need an API key with Email Address Validation permissions.
 
<call-out>

You are required to create a brand new API key that will only be used for Email Address Validation. The Email Validation dashboard will appear in the SendGrid UI for the user that creates the Email Validation API Key. 

</call-out>

1. Navigate to **Settings**, and then select **API Keys**. Click **Create API Key** in the upper right-hand corner.
1. Name your new key and select the **Email Address Validation Access** permission.
1. Select **Full Access** to the left of **Validation**.

![]({{root_url}}/img/create-api-key.png "API Key Access Permissions List")

<call-out>

“Email Address Validation Access” will be visible to Email API Pro and Premier plans only.

</call-out>

4. Click **Create & View**.
5. Copy your new API key somewhere safe. **This will be the only time you will be able to see it in its entirety due to security reasons.**

You’re now ready to start using the Real Time API endpoint! 


## Recommendations Before Integrating

The Email Address Validation Real Time API Endpoint takes a single email address in a POST request, and returns a verdict with detailed data in a JSON response. Complete documentation of the endpoint, including details of the response, are available [here](https://sendgrid-email-validation.api-docs.io/v3/getting-started/authentication).

When integrating with the Email Validation API endpoint, please keep the following things in mind:

- Do not call the API endpoint from client side code such as Javascript. Doing so would allow anyone to find your API key and use it to validate their own email addresses on your account. You should instead call the API from backend code, for instance, after the user submits a form.
- The API currently accepts one email address at a time. If for some reason you have multiple addresses you need to validate, please call the API once per email address. We do not currently have a batch API.
- If you choose to integrate into a signup form we recommend ensuring the Email Validaiton API is not a blocker for your form submissions. <commit_msg>remove beta and link to new api reference<commit_after>---
layout: page
weight: 55
title: Email Address Validation
group: managing-contacts
navigation:
  show: true
seo:
  title: Email Address Validation
  keywords: email, validation, signup
  override: true
  description: Twilio SendGrid's real-time Email Address Validation provides you detailed information on the validity of your users' email addresses, as well as allows you to integrate this validation process into your signup process. 

---
Email Address Validation provides real-time detailed information on the validity of email addresses. You can integrate this validation process into your platform's signup form and customize the best use of email address validation for your use case: - Identify a validation threshold from which you feel comfortable sending a follow up email
- Display to your form visitors that their email addresses are likely invalid within your form
- Decide if you want to drop invalid email addresses from your database.

Validating email addresses allows you to to suppress invalid email addresses from your sending, decreasing your bounce rate, cleaning your subscriber list, ultimately improving your sender reputation.

## Generating your Email Validation API Key

Before you can call the Email Address Validation Real Time API endpoint, you’ll need an API key with Email Address Validation permissions.
 
<call-out>

You are required to create a brand new API key that will only be used for Email Address Validation. The Email Validation dashboard will appear in the SendGrid UI for the user that creates the Email Validation API Key. 

</call-out>

1. Navigate to **Settings**, and then select **API Keys**. Click **Create API Key** in the upper right-hand corner.
1. Name your new key and select the **Email Address Validation Access** permission.
1. Select **Full Access** to the left of **Validation**.

![]({{root_url}}/img/create-api-key.png "API Key Access Permissions List")

<call-out>

“Email Address Validation Access” will be visible to Email API Pro and Premier plans only.

</call-out>

4. Click **Create & View**.
5. Copy your new API key somewhere safe. **This will be the only time you will be able to see it in its entirety due to security reasons.**

You’re now ready to start using the [Real Time API endpoint!](https://sendgrid.api-docs.io/v3.0/email-address-validation/validate-an-email) 


## Recommendations Before Integrating

The Email Address Validation Real Time API Endpoint takes a single email address in a POST request, and returns a verdict with detailed data in a JSON response. Complete documentation of the endpoint, including details of the response, are available [here](https://sendgrid.api-docs.io/v3.0/email-address-validation/validate-an-email).

When integrating with the Email Validation API endpoint, please keep the following things in mind:

- Do not call the API endpoint from client side code such as Javascript. Doing so would allow anyone to find your API key and use it to validate their own email addresses on your account. You should instead call the API from backend code, for instance, after the user submits a form.
- The API currently accepts one email address at a time. If for some reason you have multiple addresses you need to validate, please call the API once per email address. We do not currently have a batch API.
- If you choose to integrate into a signup form we recommend ensuring the Email Validaiton API is not a blocker for your form submissions. 
{'fraction_non_alphanumeric': 0.050516485071458894, 'fraction_numerical': 0.002688552426772322, 'mean_word_length': 4.4579150579150575, 'pattern_counts': {'":': 0, '<': 11, '<?xml version=': 0, '>': 11, 'https://': 3, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3138302', 'n_tokens_mistral': 1680, 'n_tokens_neox': 1580, 'n_words': 1055}