.. _aws-boto3-ses-verify:

############################################ Verifying email identities in Amazon SES ############################################

.. meta:: :description: Use Amazon SES API to verify email addresses and domains. :keywords: SES Python

When you first start using your Amazon Simple Email Service (SES) account, all senders and recipients must be verified in the same AWS Region that you will be sending emails to. For more information about sending emails, see Sending Email with Amazon SES <https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-email.html>__.

The following examples show how to:

Verify an email address using verify_email_identity() <https://docs.aws.amazon.com/boto3/latest/reference/services/ses/client/verify_email_identity.html>__.
Verify an email domain using verify_domain_identity() <https://docs.aws.amazon.com/boto3/latest/reference/services/ses/client/verify_domain_identity.html>__.
List all email addresses or domains using list_identities() <https://docs.aws.amazon.com/boto3/latest/reference/services/ses/client/list_identities.html>__.
Remove an email address or domain using delete_identity() <https://docs.aws.amazon.com/boto3/latest/reference/services/ses/client/delete_identity.html>__.

Prerequisite tasks

To set up and run this example, you must first complete these tasks:

Configure your AWS credentials, as described in :doc:quickstart.

Verify an email address

SES can send email only from verified email addresses or domains. By verifying an email address, you demonstrate that you're the owner of that address and want to allow SES to send email from that address.

When you run the following code example, SES sends an email to the address you specified. When you (or the recipient of the email) click the link in the email, the address is verified.

To add an email address to your SES account, use the VerifyEmailIdentity <https://docs.aws.amazon.com/ses/latest/APIReference/API_VerifyEmailIdentity.html>__ operation.

Example

.. code-block:: python

import boto3

# Create SES client
ses = boto3.client('ses')

response = ses.verify_email_identity(
  EmailAddress = 'EMAIL_ADDRESS'
)

print(response)

Verify an email domain

SES can send email only from verified email addresses or domains. By verifying a domain, you demonstrate that you're the owner of that domain. When you verify a domain, you allow SES to send email from any address on that domain.

When you run the following code example, SES provides you with a verification token. You have to add the token to your domain's DNS configuration. For more information, see Verifying a Domain with Amazon SES <http://aws.amazon.com/documentation/ses/verify-domain-procedure.html>_.

To add a sending domain to your SES account, use the VerifyDomainIdentity <https://docs.aws.amazon.com/ses/latest/APIReference/API_VerifyDomainIdentity.html>_ operation.

Example

.. code-block:: python

import boto3

# Create SES client
ses = boto3.client('ses')

response = ses.verify_domain_identity(
  Domain='DOMAIN_NAME'
)

print(response)

List email addresses

To retrieve a list of email addresses submitted in the current AWS Region, regardless of verification status, use the ListIdentities <https://docs.aws.amazon.com/ses/latest/APIReference/API_ListIdentities.html>__ operation.

Example

.. code-block:: python

import boto3

# Create SES client
ses = boto3.client('ses')

response = ses.list_identities(
  IdentityType = 'EmailAddress',
  MaxItems=10
)

print(response)

List email domains

To retrieve a list of email domains submitted in the current AWS Region, regardless of verification status use the ListIdentities <https://docs.aws.amazon.com/ses/latest/APIReference/API_ListIdentities.html>__ operation.

Example

.. code-block:: python

import boto3

# Create SES client
ses = boto3.client('ses')

response = ses.list_identities(
  IdentityType = 'Domain',
  MaxItems=10
)

print(response)

Delete an email address

To delete a verified email address from the list of verified identities, use the DeleteIdentity <https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteIdentity.html>__ operation.

Example

.. code-block:: python

import boto3

# Create SES client
ses = boto3.client('ses')

response = ses.delete_identity(
  Identity = 'EMAIL_ADDRESS'
)

print(response)

Delete an email domain

To delete a verified email domain from the list of verified identities, use the DeleteIdentity <https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteIdentity.html>__ operation.

Example

.. code-block:: python

import boto3

# Create SES client
ses = boto3.client('ses')

response = ses.delete_identity(
  Identity = 'DOMAIN_NAME'
)

print(response)