1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
|
.. Copyright 2010-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0
International License (the "License"). You may not use this file except in compliance with the
License. A copy of the License is located at http://creativecommons.org/licenses/by-nc-sa/4.0/.
This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied. See the License for the specific language governing permissions and
limitations under the License.
.. _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://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ses.html#SES.Client.verify_email_identity>`__.
* Verify an email domain using `verify_domain_identity() <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ses.html#SES.Client.verify_domain_identity>`__.
* List all email addresses or domains using `list_identities() <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ses.html#SES.Client.list_identities>`__.
* Remove an email address or domain using `delete_identity() <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ses.html#SES.Client.delete_identity>`__.
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)
|
