Email Identities
EmailIdentitiesService manages email identities for AWS SES. Use this service to register, verify, and manage email addresses that can be used as email senders. Typical Workflow: 1. Call AddEmailIdentity() to register an email 2. Recipient receives verification email 3. Recipient clicks verification link 4. Call ListEmailIdentities() to check verification_status 5. Once VERIFICATION_STATUS_SUCCESS, emails can be sent from this address
Base path: /email-identities
POST /email-identities/AddEmailIdentity
Section titled “POST /email-identities/AddEmailIdentity”AddEmailIdentity registers a new email address with SES.
Request (AddEmailIdentityRequest)
| Field | Type | Description |
|---|---|---|
email | string |
Response (AddEmailIdentityResponse)
| Field | Type | Description |
|---|---|---|
identity | SESIdentity |
POST /email-identities/ListEmailIdentities
Section titled “POST /email-identities/ListEmailIdentities”ListEmailIdentities retrieves all registered email identities.
Request (ListEmailIdentitiesRequest)
| Field | Type | Description |
|---|---|---|
page_size | int32? | page_size: Maximum number of identities to return per page (default: 50, max: 100) |
page_token | string? | page_token: Token from previous response to retrieve the next page |
Response (ListEmailIdentitiesResponse)
| Field | Type | Description |
|---|---|---|
identities | SESIdentity[] | |
next_page_token | string | next_page_token: Token to pass to next ListEmailIdentitiesRequest for additional results Empty string means no more results |
POST /email-identities/RemoveEmailIdentity
Section titled “POST /email-identities/RemoveEmailIdentity”RemoveEmailIdentity deletes an email identity (cannot be undone).
Request (RemoveEmailIdentityRequest)
| Field | Type | Description |
|---|---|---|
email | string |
Response (RemoveEmailIdentityResponse)
No fields.
POST /email-identities/ResendVerificationEmail
Section titled “POST /email-identities/ResendVerificationEmail”ResendVerificationEmail sends another verification email for an identity.
Request (ResendVerificationEmailRequest)
| Field | Type | Description |
|---|---|---|
email | string |
Response (ResendVerificationEmailResponse)
No fields.