# Actions
<a name="API_Operations"></a>

The following actions are supported:
+  [BatchGetMetricData](API_BatchGetMetricData.md) 
+  [CancelExportJob](API_CancelExportJob.md) 
+  [CreateConfigurationSet](API_CreateConfigurationSet.md) 
+  [CreateConfigurationSetEventDestination](API_CreateConfigurationSetEventDestination.md) 
+  [CreateContact](API_CreateContact.md) 
+  [CreateContactList](API_CreateContactList.md) 
+  [CreateCustomVerificationEmailTemplate](API_CreateCustomVerificationEmailTemplate.md) 
+  [CreateDedicatedIpPool](API_CreateDedicatedIpPool.md) 
+  [CreateDeliverabilityTestReport](API_CreateDeliverabilityTestReport.md) 
+  [CreateEmailIdentity](API_CreateEmailIdentity.md) 
+  [CreateEmailIdentityPolicy](API_CreateEmailIdentityPolicy.md) 
+  [CreateEmailTemplate](API_CreateEmailTemplate.md) 
+  [CreateExportJob](API_CreateExportJob.md) 
+  [CreateImportJob](API_CreateImportJob.md) 
+  [CreateMultiRegionEndpoint](API_CreateMultiRegionEndpoint.md) 
+  [CreateTenant](API_CreateTenant.md) 
+  [CreateTenantResourceAssociation](API_CreateTenantResourceAssociation.md) 
+  [DeleteConfigurationSet](API_DeleteConfigurationSet.md) 
+  [DeleteConfigurationSetEventDestination](API_DeleteConfigurationSetEventDestination.md) 
+  [DeleteContact](API_DeleteContact.md) 
+  [DeleteContactList](API_DeleteContactList.md) 
+  [DeleteCustomVerificationEmailTemplate](API_DeleteCustomVerificationEmailTemplate.md) 
+  [DeleteDedicatedIpPool](API_DeleteDedicatedIpPool.md) 
+  [DeleteEmailIdentity](API_DeleteEmailIdentity.md) 
+  [DeleteEmailIdentityPolicy](API_DeleteEmailIdentityPolicy.md) 
+  [DeleteEmailTemplate](API_DeleteEmailTemplate.md) 
+  [DeleteMultiRegionEndpoint](API_DeleteMultiRegionEndpoint.md) 
+  [DeleteSuppressedDestination](API_DeleteSuppressedDestination.md) 
+  [DeleteTenant](API_DeleteTenant.md) 
+  [DeleteTenantResourceAssociation](API_DeleteTenantResourceAssociation.md) 
+  [GetAccount](API_GetAccount.md) 
+  [GetBlacklistReports](API_GetBlacklistReports.md) 
+  [GetConfigurationSet](API_GetConfigurationSet.md) 
+  [GetConfigurationSetEventDestinations](API_GetConfigurationSetEventDestinations.md) 
+  [GetContact](API_GetContact.md) 
+  [GetContactList](API_GetContactList.md) 
+  [GetCustomVerificationEmailTemplate](API_GetCustomVerificationEmailTemplate.md) 
+  [GetDedicatedIp](API_GetDedicatedIp.md) 
+  [GetDedicatedIpPool](API_GetDedicatedIpPool.md) 
+  [GetDedicatedIps](API_GetDedicatedIps.md) 
+  [GetDeliverabilityDashboardOptions](API_GetDeliverabilityDashboardOptions.md) 
+  [GetDeliverabilityTestReport](API_GetDeliverabilityTestReport.md) 
+  [GetDomainDeliverabilityCampaign](API_GetDomainDeliverabilityCampaign.md) 
+  [GetDomainStatisticsReport](API_GetDomainStatisticsReport.md) 
+  [GetEmailAddressInsights](API_GetEmailAddressInsights.md) 
+  [GetEmailIdentity](API_GetEmailIdentity.md) 
+  [GetEmailIdentityPolicies](API_GetEmailIdentityPolicies.md) 
+  [GetEmailTemplate](API_GetEmailTemplate.md) 
+  [GetExportJob](API_GetExportJob.md) 
+  [GetImportJob](API_GetImportJob.md) 
+  [GetMessageInsights](API_GetMessageInsights.md) 
+  [GetMultiRegionEndpoint](API_GetMultiRegionEndpoint.md) 
+  [GetReputationEntity](API_GetReputationEntity.md) 
+  [GetSuppressedDestination](API_GetSuppressedDestination.md) 
+  [GetTenant](API_GetTenant.md) 
+  [ListConfigurationSets](API_ListConfigurationSets.md) 
+  [ListContactLists](API_ListContactLists.md) 
+  [ListContacts](API_ListContacts.md) 
+  [ListCustomVerificationEmailTemplates](API_ListCustomVerificationEmailTemplates.md) 
+  [ListDedicatedIpPools](API_ListDedicatedIpPools.md) 
+  [ListDeliverabilityTestReports](API_ListDeliverabilityTestReports.md) 
+  [ListDomainDeliverabilityCampaigns](API_ListDomainDeliverabilityCampaigns.md) 
+  [ListEmailIdentities](API_ListEmailIdentities.md) 
+  [ListEmailTemplates](API_ListEmailTemplates.md) 
+  [ListExportJobs](API_ListExportJobs.md) 
+  [ListImportJobs](API_ListImportJobs.md) 
+  [ListMultiRegionEndpoints](API_ListMultiRegionEndpoints.md) 
+  [ListRecommendations](API_ListRecommendations.md) 
+  [ListReputationEntities](API_ListReputationEntities.md) 
+  [ListResourceTenants](API_ListResourceTenants.md) 
+  [ListSuppressedDestinations](API_ListSuppressedDestinations.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ListTenantResources](API_ListTenantResources.md) 
+  [ListTenants](API_ListTenants.md) 
+  [PutAccountDedicatedIpWarmupAttributes](API_PutAccountDedicatedIpWarmupAttributes.md) 
+  [PutAccountDetails](API_PutAccountDetails.md) 
+  [PutAccountSendingAttributes](API_PutAccountSendingAttributes.md) 
+  [PutAccountSuppressionAttributes](API_PutAccountSuppressionAttributes.md) 
+  [PutAccountVdmAttributes](API_PutAccountVdmAttributes.md) 
+  [PutConfigurationSetArchivingOptions](API_PutConfigurationSetArchivingOptions.md) 
+  [PutConfigurationSetDeliveryOptions](API_PutConfigurationSetDeliveryOptions.md) 
+  [PutConfigurationSetReputationOptions](API_PutConfigurationSetReputationOptions.md) 
+  [PutConfigurationSetSendingOptions](API_PutConfigurationSetSendingOptions.md) 
+  [PutConfigurationSetSuppressionOptions](API_PutConfigurationSetSuppressionOptions.md) 
+  [PutConfigurationSetTrackingOptions](API_PutConfigurationSetTrackingOptions.md) 
+  [PutConfigurationSetVdmOptions](API_PutConfigurationSetVdmOptions.md) 
+  [PutDedicatedIpInPool](API_PutDedicatedIpInPool.md) 
+  [PutDedicatedIpPoolScalingAttributes](API_PutDedicatedIpPoolScalingAttributes.md) 
+  [PutDedicatedIpWarmupAttributes](API_PutDedicatedIpWarmupAttributes.md) 
+  [PutDeliverabilityDashboardOption](API_PutDeliverabilityDashboardOption.md) 
+  [PutEmailIdentityConfigurationSetAttributes](API_PutEmailIdentityConfigurationSetAttributes.md) 
+  [PutEmailIdentityDkimAttributes](API_PutEmailIdentityDkimAttributes.md) 
+  [PutEmailIdentityDkimSigningAttributes](API_PutEmailIdentityDkimSigningAttributes.md) 
+  [PutEmailIdentityFeedbackAttributes](API_PutEmailIdentityFeedbackAttributes.md) 
+  [PutEmailIdentityMailFromAttributes](API_PutEmailIdentityMailFromAttributes.md) 
+  [PutSuppressedDestination](API_PutSuppressedDestination.md) 
+  [SendBulkEmail](API_SendBulkEmail.md) 
+  [SendCustomVerificationEmail](API_SendCustomVerificationEmail.md) 
+  [SendEmail](API_SendEmail.md) 
+  [TagResource](API_TagResource.md) 
+  [TestRenderEmailTemplate](API_TestRenderEmailTemplate.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateConfigurationSetEventDestination](API_UpdateConfigurationSetEventDestination.md) 
+  [UpdateContact](API_UpdateContact.md) 
+  [UpdateContactList](API_UpdateContactList.md) 
+  [UpdateCustomVerificationEmailTemplate](API_UpdateCustomVerificationEmailTemplate.md) 
+  [UpdateEmailIdentityPolicy](API_UpdateEmailIdentityPolicy.md) 
+  [UpdateEmailTemplate](API_UpdateEmailTemplate.md) 
+  [UpdateReputationEntityCustomerManagedStatus](API_UpdateReputationEntityCustomerManagedStatus.md) 
+  [UpdateReputationEntityPolicy](API_UpdateReputationEntityPolicy.md) 

# BatchGetMetricData
<a name="API_BatchGetMetricData"></a>

Retrieves batches of metric data collected based on your sending activity.

You can execute this operation no more than 16 times per second, and with at most 160 queries from the batches per second (cumulative).

## Request Syntax
<a name="API_BatchGetMetricData_RequestSyntax"></a>

```
POST /v2/email/metrics/batch HTTP/1.1
Content-type: application/json

{
   "Queries": [ 
      { 
         "Dimensions": { 
            "string" : "string" 
         },
         "EndDate": number,
         "Id": "string",
         "Metric": "string",
         "Namespace": "string",
         "StartDate": number
      }
   ]
}
```

## URI Request Parameters
<a name="API_BatchGetMetricData_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_BatchGetMetricData_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Queries](#API_BatchGetMetricData_RequestSyntax) **   <a name="SES-BatchGetMetricData-request-Queries"></a>
A list of queries for metrics to be retrieved.  
Type: Array of [BatchGetMetricDataQuery](API_BatchGetMetricDataQuery.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Required: Yes

## Response Syntax
<a name="API_BatchGetMetricData_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Errors": [ 
      { 
         "Code": "string",
         "Id": "string",
         "Message": "string"
      }
   ],
   "Results": [ 
      { 
         "Id": "string",
         "Timestamps": [ number ],
         "Values": [ number ]
      }
   ]
}
```

## Response Elements
<a name="API_BatchGetMetricData_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Errors](#API_BatchGetMetricData_ResponseSyntax) **   <a name="SES-BatchGetMetricData-response-Errors"></a>
A list of `MetricDataError` encountered while processing your metric data batch request.  
Type: Array of [MetricDataError](API_MetricDataError.md) objects

 ** [Results](#API_BatchGetMetricData_ResponseSyntax) **   <a name="SES-BatchGetMetricData-response-Results"></a>
A list of successfully retrieved `MetricDataResult`.  
Type: Array of [MetricDataResult](API_MetricDataResult.md) objects

## Errors
<a name="API_BatchGetMetricData_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** InternalServiceErrorException **   
The request couldn't be processed because an error occurred with the Amazon SES API v2.  
HTTP Status Code: 500

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_BatchGetMetricData_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/BatchGetMetricData) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/BatchGetMetricData) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/BatchGetMetricData) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/BatchGetMetricData) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/BatchGetMetricData) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/BatchGetMetricData) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/BatchGetMetricData) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/BatchGetMetricData) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/BatchGetMetricData) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/BatchGetMetricData) 

# CancelExportJob
<a name="API_CancelExportJob"></a>

Cancels an export job.

## Request Syntax
<a name="API_CancelExportJob_RequestSyntax"></a>

```
PUT /v2/email/export-jobs/JobId/cancel HTTP/1.1
```

## URI Request Parameters
<a name="API_CancelExportJob_RequestParameters"></a>

The request uses the following URI parameters.

 ** [JobId](#API_CancelExportJob_RequestSyntax) **   <a name="SES-CancelExportJob-request-uri-JobId"></a>
The export job ID.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_CancelExportJob_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_CancelExportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_CancelExportJob_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_CancelExportJob_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CancelExportJob_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CancelExportJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CancelExportJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CancelExportJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CancelExportJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CancelExportJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CancelExportJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CancelExportJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CancelExportJob) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CancelExportJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CancelExportJob) 

# CreateConfigurationSet
<a name="API_CreateConfigurationSet"></a>

Create a configuration set. *Configuration sets* are groups of rules that you can apply to the emails that you send. You apply a configuration set to an email by specifying the name of the configuration set when you call the Amazon SES API v2. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email. 

## Request Syntax
<a name="API_CreateConfigurationSet_RequestSyntax"></a>

```
POST /v2/email/configuration-sets HTTP/1.1
Content-type: application/json

{
   "ArchivingOptions": { 
      "ArchiveArn": "string"
   },
   "ConfigurationSetName": "string",
   "DeliveryOptions": { 
      "MaxDeliverySeconds": number,
      "SendingPoolName": "string",
      "TlsPolicy": "string"
   },
   "ReputationOptions": { 
      "LastFreshStart": number,
      "ReputationMetricsEnabled": boolean
   },
   "SendingOptions": { 
      "SendingEnabled": boolean
   },
   "SuppressionOptions": { 
      "SuppressedReasons": [ "string" ],
      "ValidationOptions": { 
         "ConditionThreshold": { 
            "ConditionThresholdEnabled": "string",
            "OverallConfidenceThreshold": { 
               "ConfidenceVerdictThreshold": "string"
            }
         }
      }
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TrackingOptions": { 
      "CustomRedirectDomain": "string",
      "HttpsPolicy": "string"
   },
   "VdmOptions": { 
      "DashboardOptions": { 
         "EngagementMetrics": "string"
      },
      "GuardianOptions": { 
         "OptimizedSharedDelivery": "string"
      }
   }
}
```

## URI Request Parameters
<a name="API_CreateConfigurationSet_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateConfigurationSet_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ArchivingOptions](#API_CreateConfigurationSet_RequestSyntax) **   <a name="SES-CreateConfigurationSet-request-ArchivingOptions"></a>
An object that defines the MailManager archiving options for emails that you send using the configuration set.  
Type: [ArchivingOptions](API_ArchivingOptions.md) object  
Required: No

 ** [ConfigurationSetName](#API_CreateConfigurationSet_RequestSyntax) **   <a name="SES-CreateConfigurationSet-request-ConfigurationSetName"></a>
The name of the configuration set. The name can contain up to 64 alphanumeric characters, including letters, numbers, hyphens (-) and underscores (\$1) only.  
Type: String  
Required: Yes

 ** [DeliveryOptions](#API_CreateConfigurationSet_RequestSyntax) **   <a name="SES-CreateConfigurationSet-request-DeliveryOptions"></a>
An object that defines the dedicated IP pool that is used to send emails that you send using the configuration set.  
Type: [DeliveryOptions](API_DeliveryOptions.md) object  
Required: No

 ** [ReputationOptions](#API_CreateConfigurationSet_RequestSyntax) **   <a name="SES-CreateConfigurationSet-request-ReputationOptions"></a>
An object that defines whether or not Amazon SES collects reputation metrics for the emails that you send that use the configuration set.  
Type: [ReputationOptions](API_ReputationOptions.md) object  
Required: No

 ** [SendingOptions](#API_CreateConfigurationSet_RequestSyntax) **   <a name="SES-CreateConfigurationSet-request-SendingOptions"></a>
An object that defines whether or not Amazon SES can send email that you send using the configuration set.  
Type: [SendingOptions](API_SendingOptions.md) object  
Required: No

 ** [SuppressionOptions](#API_CreateConfigurationSet_RequestSyntax) **   <a name="SES-CreateConfigurationSet-request-SuppressionOptions"></a>
An object that contains information about the suppression list preferences for your account.  
Type: [SuppressionOptions](API_SuppressionOptions.md) object  
Required: No

 ** [Tags](#API_CreateConfigurationSet_RequestSyntax) **   <a name="SES-CreateConfigurationSet-request-Tags"></a>
An array of objects that define the tags (keys and values) to associate with the configuration set.  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

 ** [TrackingOptions](#API_CreateConfigurationSet_RequestSyntax) **   <a name="SES-CreateConfigurationSet-request-TrackingOptions"></a>
An object that defines the open and click tracking options for emails that you send using the configuration set.  
Type: [TrackingOptions](API_TrackingOptions.md) object  
Required: No

 ** [VdmOptions](#API_CreateConfigurationSet_RequestSyntax) **   <a name="SES-CreateConfigurationSet-request-VdmOptions"></a>
An object that defines the VDM options for emails that you send using the configuration set.  
Type: [VdmOptions](API_VdmOptions.md) object  
Required: No

## Response Syntax
<a name="API_CreateConfigurationSet_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_CreateConfigurationSet_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_CreateConfigurationSet_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateConfigurationSet_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateConfigurationSet) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateConfigurationSet) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateConfigurationSet) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateConfigurationSet) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateConfigurationSet) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateConfigurationSet) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateConfigurationSet) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateConfigurationSet) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateConfigurationSet) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateConfigurationSet) 

# CreateConfigurationSetEventDestination
<a name="API_CreateConfigurationSetEventDestination"></a>

Create an event destination. *Events* include message sends, deliveries, opens, clicks, bounces, and complaints. *Event destinations* are places that you can send information about these events to. For example, you can send event data to Amazon EventBridge and associate a rule to send the event to the specified target.

A single configuration set can include more than one event destination.

## Request Syntax
<a name="API_CreateConfigurationSetEventDestination_RequestSyntax"></a>

```
POST /v2/email/configuration-sets/ConfigurationSetName/event-destinations HTTP/1.1
Content-type: application/json

{
   "EventDestination": { 
      "CloudWatchDestination": { 
         "DimensionConfigurations": [ 
            { 
               "DefaultDimensionValue": "string",
               "DimensionName": "string",
               "DimensionValueSource": "string"
            }
         ]
      },
      "Enabled": boolean,
      "EventBridgeDestination": { 
         "EventBusArn": "string"
      },
      "KinesisFirehoseDestination": { 
         "DeliveryStreamArn": "string",
         "IamRoleArn": "string"
      },
      "MatchingEventTypes": [ "string" ],
      "PinpointDestination": { 
         "ApplicationArn": "string"
      },
      "SnsDestination": { 
         "TopicArn": "string"
      }
   },
   "EventDestinationName": "string"
}
```

## URI Request Parameters
<a name="API_CreateConfigurationSetEventDestination_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_CreateConfigurationSetEventDestination_RequestSyntax) **   <a name="SES-CreateConfigurationSetEventDestination-request-uri-ConfigurationSetName"></a>
The name of the configuration set .  
Required: Yes

## Request Body
<a name="API_CreateConfigurationSetEventDestination_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [EventDestination](#API_CreateConfigurationSetEventDestination_RequestSyntax) **   <a name="SES-CreateConfigurationSetEventDestination-request-EventDestination"></a>
An object that defines the event destination.  
Type: [EventDestinationDefinition](API_EventDestinationDefinition.md) object  
Required: Yes

 ** [EventDestinationName](#API_CreateConfigurationSetEventDestination_RequestSyntax) **   <a name="SES-CreateConfigurationSetEventDestination-request-EventDestinationName"></a>
A name that identifies the event destination within the configuration set.  
Type: String  
Required: Yes

## Response Syntax
<a name="API_CreateConfigurationSetEventDestination_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_CreateConfigurationSetEventDestination_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_CreateConfigurationSetEventDestination_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateConfigurationSetEventDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateConfigurationSetEventDestination) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateConfigurationSetEventDestination) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateConfigurationSetEventDestination) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateConfigurationSetEventDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateConfigurationSetEventDestination) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateConfigurationSetEventDestination) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateConfigurationSetEventDestination) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateConfigurationSetEventDestination) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateConfigurationSetEventDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateConfigurationSetEventDestination) 

# CreateContact
<a name="API_CreateContact"></a>

Creates a contact, which is an end-user who is receiving the email, and adds them to a contact list.

## Request Syntax
<a name="API_CreateContact_RequestSyntax"></a>

```
POST /v2/email/contact-lists/ContactListName/contacts HTTP/1.1
Content-type: application/json

{
   "AttributesData": "string",
   "EmailAddress": "string",
   "TopicPreferences": [ 
      { 
         "SubscriptionStatus": "string",
         "TopicName": "string"
      }
   ],
   "UnsubscribeAll": boolean
}
```

## URI Request Parameters
<a name="API_CreateContact_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ContactListName](#API_CreateContact_RequestSyntax) **   <a name="SES-CreateContact-request-uri-ContactListName"></a>
The name of the contact list to which the contact should be added.  
Required: Yes

## Request Body
<a name="API_CreateContact_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AttributesData](#API_CreateContact_RequestSyntax) **   <a name="SES-CreateContact-request-AttributesData"></a>
The attribute data attached to a contact.  
Type: String  
Required: No

 ** [EmailAddress](#API_CreateContact_RequestSyntax) **   <a name="SES-CreateContact-request-EmailAddress"></a>
The contact's email address.  
Type: String  
Required: Yes

 ** [TopicPreferences](#API_CreateContact_RequestSyntax) **   <a name="SES-CreateContact-request-TopicPreferences"></a>
The contact's preferences for being opted-in to or opted-out of topics.  
Type: Array of [TopicPreference](API_TopicPreference.md) objects  
Required: No

 ** [UnsubscribeAll](#API_CreateContact_RequestSyntax) **   <a name="SES-CreateContact-request-UnsubscribeAll"></a>
A boolean value status noting if the contact is unsubscribed from all contact list topics.  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_CreateContact_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_CreateContact_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_CreateContact_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateContact_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateContact) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateContact) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateContact) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateContact) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateContact) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateContact) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateContact) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateContact) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateContact) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateContact) 

# CreateContactList
<a name="API_CreateContactList"></a>

Creates a contact list.

## Request Syntax
<a name="API_CreateContactList_RequestSyntax"></a>

```
POST /v2/email/contact-lists HTTP/1.1
Content-type: application/json

{
   "ContactListName": "string",
   "Description": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "Topics": [ 
      { 
         "DefaultSubscriptionStatus": "string",
         "Description": "string",
         "DisplayName": "string",
         "TopicName": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_CreateContactList_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateContactList_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ContactListName](#API_CreateContactList_RequestSyntax) **   <a name="SES-CreateContactList-request-ContactListName"></a>
The name of the contact list.  
Type: String  
Required: Yes

 ** [Description](#API_CreateContactList_RequestSyntax) **   <a name="SES-CreateContactList-request-Description"></a>
A description of what the contact list is about.  
Type: String  
Required: No

 ** [Tags](#API_CreateContactList_RequestSyntax) **   <a name="SES-CreateContactList-request-Tags"></a>
The tags associated with a contact list.  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

 ** [Topics](#API_CreateContactList_RequestSyntax) **   <a name="SES-CreateContactList-request-Topics"></a>
An interest group, theme, or label within a list. A contact list can have multiple topics.  
Type: Array of [Topic](API_Topic.md) objects  
Required: No

## Response Syntax
<a name="API_CreateContactList_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_CreateContactList_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_CreateContactList_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateContactList_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateContactList) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateContactList) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateContactList) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateContactList) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateContactList) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateContactList) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateContactList) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateContactList) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateContactList) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateContactList) 

# CreateCustomVerificationEmailTemplate
<a name="API_CreateCustomVerificationEmailTemplate"></a>

Creates a new custom verification email template.

For more information about custom verification email templates, see [Using custom verification email templates](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) in the *Amazon SES Developer Guide*.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_CreateCustomVerificationEmailTemplate_RequestSyntax"></a>

```
POST /v2/email/custom-verification-email-templates HTTP/1.1
Content-type: application/json

{
   "FailureRedirectionURL": "string",
   "FromEmailAddress": "string",
   "SuccessRedirectionURL": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TemplateContent": "string",
   "TemplateName": "string",
   "TemplateSubject": "string"
}
```

## URI Request Parameters
<a name="API_CreateCustomVerificationEmailTemplate_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateCustomVerificationEmailTemplate_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [FailureRedirectionURL](#API_CreateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-CreateCustomVerificationEmailTemplate-request-FailureRedirectionURL"></a>
The URL that the recipient of the verification email is sent to if his or her address is not successfully verified.  
Type: String  
Required: Yes

 ** [FromEmailAddress](#API_CreateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-CreateCustomVerificationEmailTemplate-request-FromEmailAddress"></a>
The email address that the custom verification email is sent from.  
Type: String  
Required: Yes

 ** [SuccessRedirectionURL](#API_CreateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-CreateCustomVerificationEmailTemplate-request-SuccessRedirectionURL"></a>
The URL that the recipient of the verification email is sent to if his or her address is successfully verified.  
Type: String  
Required: Yes

 ** [Tags](#API_CreateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-CreateCustomVerificationEmailTemplate-request-Tags"></a>
An array of objects that define the tags (keys and values) to associate with the custom verification email template.  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

 ** [TemplateContent](#API_CreateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-CreateCustomVerificationEmailTemplate-request-TemplateContent"></a>
The content of the custom verification email. The total size of the email must be less than 10 MB. The message body may contain HTML, with some limitations. For more information, see [Custom verification email frequently asked questions](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom-faq) in the *Amazon SES Developer Guide*.  
Type: String  
Required: Yes

 ** [TemplateName](#API_CreateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-CreateCustomVerificationEmailTemplate-request-TemplateName"></a>
The name of the custom verification email template.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [TemplateSubject](#API_CreateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-CreateCustomVerificationEmailTemplate-request-TemplateSubject"></a>
The subject line of the custom verification email.  
Type: String  
Required: Yes

## Response Syntax
<a name="API_CreateCustomVerificationEmailTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_CreateCustomVerificationEmailTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_CreateCustomVerificationEmailTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateCustomVerificationEmailTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateCustomVerificationEmailTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateCustomVerificationEmailTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateCustomVerificationEmailTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateCustomVerificationEmailTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateCustomVerificationEmailTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateCustomVerificationEmailTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateCustomVerificationEmailTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateCustomVerificationEmailTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateCustomVerificationEmailTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateCustomVerificationEmailTemplate) 

# CreateDedicatedIpPool
<a name="API_CreateDedicatedIpPool"></a>

Create a new pool of dedicated IP addresses. A pool can include one or more dedicated IP addresses that are associated with your AWS account. You can associate a pool with a configuration set. When you send an email that uses that configuration set, the message is sent from one of the addresses in the associated pool.

## Request Syntax
<a name="API_CreateDedicatedIpPool_RequestSyntax"></a>

```
POST /v2/email/dedicated-ip-pools HTTP/1.1
Content-type: application/json

{
   "PoolName": "string",
   "ScalingMode": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_CreateDedicatedIpPool_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateDedicatedIpPool_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [PoolName](#API_CreateDedicatedIpPool_RequestSyntax) **   <a name="SES-CreateDedicatedIpPool-request-PoolName"></a>
The name of the dedicated IP pool.  
Type: String  
Required: Yes

 ** [ScalingMode](#API_CreateDedicatedIpPool_RequestSyntax) **   <a name="SES-CreateDedicatedIpPool-request-ScalingMode"></a>
The type of scaling mode.  
Type: String  
Valid Values: `STANDARD | MANAGED`   
Required: No

 ** [Tags](#API_CreateDedicatedIpPool_RequestSyntax) **   <a name="SES-CreateDedicatedIpPool-request-Tags"></a>
An object that defines the tags (keys and values) that you want to associate with the pool.  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

## Response Syntax
<a name="API_CreateDedicatedIpPool_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_CreateDedicatedIpPool_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_CreateDedicatedIpPool_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateDedicatedIpPool_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateDedicatedIpPool) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateDedicatedIpPool) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateDedicatedIpPool) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateDedicatedIpPool) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateDedicatedIpPool) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateDedicatedIpPool) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateDedicatedIpPool) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateDedicatedIpPool) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateDedicatedIpPool) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateDedicatedIpPool) 

# CreateDeliverabilityTestReport
<a name="API_CreateDeliverabilityTestReport"></a>

Create a new predictive inbox placement test. Predictive inbox placement tests can help you predict how your messages will be handled by various email providers around the world. When you perform a predictive inbox placement test, you provide a sample message that contains the content that you plan to send to your customers. Amazon SES then sends that message to special email addresses spread across several major email providers. After about 24 hours, the test is complete, and you can use the `GetDeliverabilityTestReport` operation to view the results of the test.

## Request Syntax
<a name="API_CreateDeliverabilityTestReport_RequestSyntax"></a>

```
POST /v2/email/deliverability-dashboard/test HTTP/1.1
Content-type: application/json

{
   "Content": { 
      "Raw": { 
         "Data": blob
      },
      "Simple": { 
         "Attachments": [ 
            { 
               "ContentDescription": "string",
               "ContentDisposition": "string",
               "ContentId": "string",
               "ContentTransferEncoding": "string",
               "ContentType": "string",
               "FileName": "string",
               "RawContent": blob
            }
         ],
         "Body": { 
            "Html": { 
               "Charset": "string",
               "Data": "string"
            },
            "Text": { 
               "Charset": "string",
               "Data": "string"
            }
         },
         "Headers": [ 
            { 
               "Name": "string",
               "Value": "string"
            }
         ],
         "Subject": { 
            "Charset": "string",
            "Data": "string"
         }
      },
      "Template": { 
         "Attachments": [ 
            { 
               "ContentDescription": "string",
               "ContentDisposition": "string",
               "ContentId": "string",
               "ContentTransferEncoding": "string",
               "ContentType": "string",
               "FileName": "string",
               "RawContent": blob
            }
         ],
         "Headers": [ 
            { 
               "Name": "string",
               "Value": "string"
            }
         ],
         "TemplateArn": "string",
         "TemplateContent": { 
            "Html": "string",
            "Subject": "string",
            "Text": "string"
         },
         "TemplateData": "string",
         "TemplateName": "string"
      }
   },
   "FromEmailAddress": "string",
   "ReportName": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_CreateDeliverabilityTestReport_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateDeliverabilityTestReport_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Content](#API_CreateDeliverabilityTestReport_RequestSyntax) **   <a name="SES-CreateDeliverabilityTestReport-request-Content"></a>
The HTML body of the message that you sent when you performed the predictive inbox placement test.  
Type: [EmailContent](API_EmailContent.md) object  
Required: Yes

 ** [FromEmailAddress](#API_CreateDeliverabilityTestReport_RequestSyntax) **   <a name="SES-CreateDeliverabilityTestReport-request-FromEmailAddress"></a>
The email address that the predictive inbox placement test email was sent from.  
Type: String  
Required: Yes

 ** [ReportName](#API_CreateDeliverabilityTestReport_RequestSyntax) **   <a name="SES-CreateDeliverabilityTestReport-request-ReportName"></a>
A unique name that helps you to identify the predictive inbox placement test when you retrieve the results.  
Type: String  
Required: No

 ** [Tags](#API_CreateDeliverabilityTestReport_RequestSyntax) **   <a name="SES-CreateDeliverabilityTestReport-request-Tags"></a>
An array of objects that define the tags (keys and values) that you want to associate with the predictive inbox placement test.  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

## Response Syntax
<a name="API_CreateDeliverabilityTestReport_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DeliverabilityTestStatus": "string",
   "ReportId": "string"
}
```

## Response Elements
<a name="API_CreateDeliverabilityTestReport_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DeliverabilityTestStatus](#API_CreateDeliverabilityTestReport_ResponseSyntax) **   <a name="SES-CreateDeliverabilityTestReport-response-DeliverabilityTestStatus"></a>
The status of the predictive inbox placement test. If the status is `IN_PROGRESS`, then the predictive inbox placement test is currently running. Predictive inbox placement tests are usually complete within 24 hours of creating the test. If the status is `COMPLETE`, then the test is finished, and you can use the `GetDeliverabilityTestReport` to view the results of the test.  
Type: String  
Valid Values: `IN_PROGRESS | COMPLETED` 

 ** [ReportId](#API_CreateDeliverabilityTestReport_ResponseSyntax) **   <a name="SES-CreateDeliverabilityTestReport-response-ReportId"></a>
A unique string that identifies the predictive inbox placement test.  
Type: String

## Errors
<a name="API_CreateDeliverabilityTestReport_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccountSuspendedException **   
The message can't be sent because the account's ability to send email has been permanently restricted.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** MailFromDomainNotVerifiedException **   
The message can't be sent because the sending domain isn't verified.  
HTTP Status Code: 400

 ** MessageRejected **   
The message can't be sent because it contains invalid content.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** SendingPausedException **   
The message can't be sent because the account's ability to send email is currently paused.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateDeliverabilityTestReport_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateDeliverabilityTestReport) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateDeliverabilityTestReport) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateDeliverabilityTestReport) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateDeliverabilityTestReport) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateDeliverabilityTestReport) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateDeliverabilityTestReport) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateDeliverabilityTestReport) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateDeliverabilityTestReport) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateDeliverabilityTestReport) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateDeliverabilityTestReport) 

# CreateEmailIdentity
<a name="API_CreateEmailIdentity"></a>

Starts the process of verifying an email identity. An *identity* is an email address or domain that you use when you send email. Before you can use an identity to send email, you first have to verify it. By verifying an identity, you demonstrate that you're the owner of the identity, and that you've given Amazon SES API v2 permission to send email from the identity.

When you verify an email address, Amazon SES sends an email to the address. Your email address is verified as soon as you follow the link in the verification email. 

When you verify a domain without specifying the `DkimSigningAttributes` object, this operation provides a set of DKIM tokens. You can convert these tokens into CNAME records, which you then add to the DNS configuration for your domain. Your domain is verified when Amazon SES detects these records in the DNS configuration for your domain. This verification method is known as [Easy DKIM](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html).

Alternatively, you can perform the verification process by providing your own public-private key pair. This verification method is known as Bring Your Own DKIM (BYODKIM). To use BYODKIM, your call to the `CreateEmailIdentity` operation has to include the `DkimSigningAttributes` object. When you specify this object, you provide a selector (a component of the DNS record name that identifies the public key to use for DKIM authentication) and a private key.

When you verify a domain, this operation provides a set of DKIM tokens, which you can convert into CNAME tokens. You add these CNAME tokens to the DNS configuration for your domain. Your domain is verified when Amazon SES detects these records in the DNS configuration for your domain. For some DNS providers, it can take 72 hours or more to complete the domain verification process.

Additionally, you can associate an existing configuration set with the email identity that you're verifying.

## Request Syntax
<a name="API_CreateEmailIdentity_RequestSyntax"></a>

```
POST /v2/email/identities HTTP/1.1
Content-type: application/json

{
   "ConfigurationSetName": "string",
   "DkimSigningAttributes": { 
      "DomainSigningAttributesOrigin": "string",
      "DomainSigningPrivateKey": "string",
      "DomainSigningSelector": "string",
      "NextSigningKeyLength": "string"
   },
   "EmailIdentity": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_CreateEmailIdentity_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateEmailIdentity_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ConfigurationSetName](#API_CreateEmailIdentity_RequestSyntax) **   <a name="SES-CreateEmailIdentity-request-ConfigurationSetName"></a>
The configuration set to use by default when sending from this identity. Note that any configuration set defined in the email sending request takes precedence.   
Type: String  
Required: No

 ** [DkimSigningAttributes](#API_CreateEmailIdentity_RequestSyntax) **   <a name="SES-CreateEmailIdentity-request-DkimSigningAttributes"></a>
If your request includes this object, Amazon SES configures the identity to use Bring Your Own DKIM (BYODKIM) for DKIM authentication purposes, or, configures the key length to be used for [Easy DKIM](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html).  
You can only specify this object if the email identity is a domain, as opposed to an address.  
Type: [DkimSigningAttributes](API_DkimSigningAttributes.md) object  
Required: No

 ** [EmailIdentity](#API_CreateEmailIdentity_RequestSyntax) **   <a name="SES-CreateEmailIdentity-request-EmailIdentity"></a>
The email address or domain to verify.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [Tags](#API_CreateEmailIdentity_RequestSyntax) **   <a name="SES-CreateEmailIdentity-request-Tags"></a>
An array of objects that define the tags (keys and values) to associate with the email identity.  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

## Response Syntax
<a name="API_CreateEmailIdentity_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DkimAttributes": { 
      "CurrentSigningKeyLength": "string",
      "LastKeyGenerationTimestamp": number,
      "NextSigningKeyLength": "string",
      "SigningAttributesOrigin": "string",
      "SigningEnabled": boolean,
      "SigningHostedZone": "string",
      "Status": "string",
      "Tokens": [ "string" ]
   },
   "IdentityType": "string",
   "VerifiedForSendingStatus": boolean
}
```

## Response Elements
<a name="API_CreateEmailIdentity_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DkimAttributes](#API_CreateEmailIdentity_ResponseSyntax) **   <a name="SES-CreateEmailIdentity-response-DkimAttributes"></a>
An object that contains information about the DKIM attributes for the identity.  
Type: [DkimAttributes](API_DkimAttributes.md) object

 ** [IdentityType](#API_CreateEmailIdentity_ResponseSyntax) **   <a name="SES-CreateEmailIdentity-response-IdentityType"></a>
The email identity type. Note: the `MANAGED_DOMAIN` identity type is not supported.  
Type: String  
Valid Values: `EMAIL_ADDRESS | DOMAIN | MANAGED_DOMAIN` 

 ** [VerifiedForSendingStatus](#API_CreateEmailIdentity_ResponseSyntax) **   <a name="SES-CreateEmailIdentity-response-VerifiedForSendingStatus"></a>
Specifies whether or not the identity is verified. You can only send email from verified email addresses or domains. For more information about verifying identities, see the [Amazon Pinpoint User Guide](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html).  
Type: Boolean

## Errors
<a name="API_CreateEmailIdentity_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateEmailIdentity_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateEmailIdentity) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateEmailIdentity) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateEmailIdentity) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateEmailIdentity) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateEmailIdentity) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateEmailIdentity) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateEmailIdentity) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateEmailIdentity) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateEmailIdentity) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateEmailIdentity) 

# CreateEmailIdentityPolicy
<a name="API_CreateEmailIdentityPolicy"></a>

Creates the specified sending authorization policy for the given identity (an email address or a domain).

**Note**  
This API is for the identity owner only. If you have not verified the identity, this API will return an error.

Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html).

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_CreateEmailIdentityPolicy_RequestSyntax"></a>

```
POST /v2/email/identities/EmailIdentity/policies/PolicyName HTTP/1.1
Content-type: application/json

{
   "Policy": "string"
}
```

## URI Request Parameters
<a name="API_CreateEmailIdentityPolicy_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailIdentity](#API_CreateEmailIdentityPolicy_RequestSyntax) **   <a name="SES-CreateEmailIdentityPolicy-request-uri-EmailIdentity"></a>
The email identity.  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [PolicyName](#API_CreateEmailIdentityPolicy_RequestSyntax) **   <a name="SES-CreateEmailIdentityPolicy-request-uri-PolicyName"></a>
The name of the policy.  
The policy name cannot exceed 64 characters and can only include alphanumeric characters, dashes, and underscores.  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Required: Yes

## Request Body
<a name="API_CreateEmailIdentityPolicy_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Policy](#API_CreateEmailIdentityPolicy_RequestSyntax) **   <a name="SES-CreateEmailIdentityPolicy-request-Policy"></a>
The text of the policy in JSON format. The policy cannot exceed 4 KB.  
For information about the syntax of sending authorization policies, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization-policies.html).  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_CreateEmailIdentityPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_CreateEmailIdentityPolicy_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_CreateEmailIdentityPolicy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateEmailIdentityPolicy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateEmailIdentityPolicy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateEmailIdentityPolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateEmailIdentityPolicy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateEmailIdentityPolicy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateEmailIdentityPolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateEmailIdentityPolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateEmailIdentityPolicy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateEmailIdentityPolicy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateEmailIdentityPolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateEmailIdentityPolicy) 

# CreateEmailTemplate
<a name="API_CreateEmailTemplate"></a>

Creates an email template. Email templates enable you to send personalized email to one or more destinations in a single API operation. For more information, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-personalized-email-api.html).

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_CreateEmailTemplate_RequestSyntax"></a>

```
POST /v2/email/templates HTTP/1.1
Content-type: application/json

{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TemplateContent": { 
      "Html": "string",
      "Subject": "string",
      "Text": "string"
   },
   "TemplateName": "string"
}
```

## URI Request Parameters
<a name="API_CreateEmailTemplate_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateEmailTemplate_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Tags](#API_CreateEmailTemplate_RequestSyntax) **   <a name="SES-CreateEmailTemplate-request-Tags"></a>
An array of objects that define the tags (keys and values) to associate with the email template.  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

 ** [TemplateContent](#API_CreateEmailTemplate_RequestSyntax) **   <a name="SES-CreateEmailTemplate-request-TemplateContent"></a>
The content of the email template, composed of a subject line, an HTML part, and a text-only part.  
Type: [EmailTemplateContent](API_EmailTemplateContent.md) object  
Required: Yes

 ** [TemplateName](#API_CreateEmailTemplate_RequestSyntax) **   <a name="SES-CreateEmailTemplate-request-TemplateName"></a>
The name of the template.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_CreateEmailTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_CreateEmailTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_CreateEmailTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateEmailTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateEmailTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateEmailTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateEmailTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateEmailTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateEmailTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateEmailTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateEmailTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateEmailTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateEmailTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateEmailTemplate) 

# CreateExportJob
<a name="API_CreateExportJob"></a>

Creates an export job for a data source and destination.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_CreateExportJob_RequestSyntax"></a>

```
POST /v2/email/export-jobs HTTP/1.1
Content-type: application/json

{
   "ExportDataSource": { 
      "MessageInsightsDataSource": { 
         "EndDate": number,
         "Exclude": { 
            "Destination": [ "string" ],
            "FromEmailAddress": [ "string" ],
            "Isp": [ "string" ],
            "LastDeliveryEvent": [ "string" ],
            "LastEngagementEvent": [ "string" ],
            "Subject": [ "string" ]
         },
         "Include": { 
            "Destination": [ "string" ],
            "FromEmailAddress": [ "string" ],
            "Isp": [ "string" ],
            "LastDeliveryEvent": [ "string" ],
            "LastEngagementEvent": [ "string" ],
            "Subject": [ "string" ]
         },
         "MaxResults": number,
         "StartDate": number
      },
      "MetricsDataSource": { 
         "Dimensions": { 
            "string" : [ "string" ]
         },
         "EndDate": number,
         "Metrics": [ 
            { 
               "Aggregation": "string",
               "Name": "string"
            }
         ],
         "Namespace": "string",
         "StartDate": number
      }
   },
   "ExportDestination": { 
      "DataFormat": "string",
      "S3Url": "string"
   }
}
```

## URI Request Parameters
<a name="API_CreateExportJob_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateExportJob_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ExportDataSource](#API_CreateExportJob_RequestSyntax) **   <a name="SES-CreateExportJob-request-ExportDataSource"></a>
The data source for the export job.  
Type: [ExportDataSource](API_ExportDataSource.md) object  
Required: Yes

 ** [ExportDestination](#API_CreateExportJob_RequestSyntax) **   <a name="SES-CreateExportJob-request-ExportDestination"></a>
The destination for the export job.  
Type: [ExportDestination](API_ExportDestination.md) object  
Required: Yes

## Response Syntax
<a name="API_CreateExportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "JobId": "string"
}
```

## Response Elements
<a name="API_CreateExportJob_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [JobId](#API_CreateExportJob_ResponseSyntax) **   <a name="SES-CreateExportJob-response-JobId"></a>
A string that represents the export job ID.  
Type: String  
Length Constraints: Minimum length of 1.

## Errors
<a name="API_CreateExportJob_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateExportJob_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateExportJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateExportJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateExportJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateExportJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateExportJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateExportJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateExportJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateExportJob) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateExportJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateExportJob) 

# CreateImportJob
<a name="API_CreateImportJob"></a>

Creates an import job for a data destination.

## Request Syntax
<a name="API_CreateImportJob_RequestSyntax"></a>

```
POST /v2/email/import-jobs HTTP/1.1
Content-type: application/json

{
   "ImportDataSource": { 
      "DataFormat": "string",
      "S3Url": "string"
   },
   "ImportDestination": { 
      "ContactListDestination": { 
         "ContactListImportAction": "string",
         "ContactListName": "string"
      },
      "SuppressionListDestination": { 
         "SuppressionListImportAction": "string"
      }
   }
}
```

## URI Request Parameters
<a name="API_CreateImportJob_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateImportJob_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ImportDataSource](#API_CreateImportJob_RequestSyntax) **   <a name="SES-CreateImportJob-request-ImportDataSource"></a>
The data source for the import job.  
Type: [ImportDataSource](API_ImportDataSource.md) object  
Required: Yes

 ** [ImportDestination](#API_CreateImportJob_RequestSyntax) **   <a name="SES-CreateImportJob-request-ImportDestination"></a>
The destination for the import job.  
Type: [ImportDestination](API_ImportDestination.md) object  
Required: Yes

## Response Syntax
<a name="API_CreateImportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "JobId": "string"
}
```

## Response Elements
<a name="API_CreateImportJob_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [JobId](#API_CreateImportJob_ResponseSyntax) **   <a name="SES-CreateImportJob-response-JobId"></a>
A string that represents the import job ID.  
Type: String  
Length Constraints: Minimum length of 1.

## Errors
<a name="API_CreateImportJob_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateImportJob_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateImportJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateImportJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateImportJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateImportJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateImportJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateImportJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateImportJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateImportJob) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateImportJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateImportJob) 

# CreateMultiRegionEndpoint
<a name="API_CreateMultiRegionEndpoint"></a>

Creates a multi-region endpoint (global-endpoint).

The primary region is going to be the AWS-Region where the operation is executed. The secondary region has to be provided in request's parameters. From the data flow standpoint there is no difference between primary and secondary regions - sending traffic will be split equally between the two. The primary region is the region where the resource has been created and where it can be managed. 

## Request Syntax
<a name="API_CreateMultiRegionEndpoint_RequestSyntax"></a>

```
POST /v2/email/multi-region-endpoints HTTP/1.1
Content-type: application/json

{
   "Details": { 
      "RoutesDetails": [ 
         { 
            "Region": "string"
         }
      ]
   },
   "EndpointName": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_CreateMultiRegionEndpoint_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateMultiRegionEndpoint_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Details](#API_CreateMultiRegionEndpoint_RequestSyntax) **   <a name="SES-CreateMultiRegionEndpoint-request-Details"></a>
Contains details of a multi-region endpoint (global-endpoint) being created.  
Type: [Details](API_Details.md) object  
Required: Yes

 ** [EndpointName](#API_CreateMultiRegionEndpoint_RequestSyntax) **   <a name="SES-CreateMultiRegionEndpoint-request-EndpointName"></a>
The name of the multi-region endpoint (global-endpoint).  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `^[\w\-_]+$`   
Required: Yes

 ** [Tags](#API_CreateMultiRegionEndpoint_RequestSyntax) **   <a name="SES-CreateMultiRegionEndpoint-request-Tags"></a>
An array of objects that define the tags (keys and values) to associate with the multi-region endpoint (global-endpoint).  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

## Response Syntax
<a name="API_CreateMultiRegionEndpoint_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "EndpointId": "string",
   "Status": "string"
}
```

## Response Elements
<a name="API_CreateMultiRegionEndpoint_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [EndpointId](#API_CreateMultiRegionEndpoint_ResponseSyntax) **   <a name="SES-CreateMultiRegionEndpoint-response-EndpointId"></a>
The ID of the multi-region endpoint (global-endpoint).  
Type: String

 ** [Status](#API_CreateMultiRegionEndpoint_ResponseSyntax) **   <a name="SES-CreateMultiRegionEndpoint-response-Status"></a>
A status of the multi-region endpoint (global-endpoint) right after the create request.  
+  `CREATING` – The resource is being provisioned.
+  `READY` – The resource is ready to use.
+  `FAILED` – The resource failed to be provisioned.
+  `DELETING` – The resource is being deleted as requested.
Type: String  
Valid Values: `CREATING | READY | FAILED | DELETING` 

## Errors
<a name="API_CreateMultiRegionEndpoint_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateMultiRegionEndpoint_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateMultiRegionEndpoint) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateMultiRegionEndpoint) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateMultiRegionEndpoint) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateMultiRegionEndpoint) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateMultiRegionEndpoint) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateMultiRegionEndpoint) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateMultiRegionEndpoint) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateMultiRegionEndpoint) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateMultiRegionEndpoint) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateMultiRegionEndpoint) 

# CreateTenant
<a name="API_CreateTenant"></a>

Create a tenant.

 *Tenants* are logical containers that group related SES resources together. Each tenant can have its own set of resources like email identities, configuration sets, and templates, along with reputation metrics and sending status. This helps isolate and manage email sending for different customers or business units within your Amazon SES API v2 account.

## Request Syntax
<a name="API_CreateTenant_RequestSyntax"></a>

```
POST /v2/email/tenants HTTP/1.1
Content-type: application/json

{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TenantName": "string"
}
```

## URI Request Parameters
<a name="API_CreateTenant_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateTenant_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Tags](#API_CreateTenant_RequestSyntax) **   <a name="SES-CreateTenant-request-Tags"></a>
An array of objects that define the tags (keys and values) to associate with the tenant  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

 ** [TenantName](#API_CreateTenant_RequestSyntax) **   <a name="SES-CreateTenant-request-TenantName"></a>
The name of the tenant to create. The name can contain up to 64 alphanumeric characters, including letters, numbers, hyphens (-) and underscores (\$1) only.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_CreateTenant_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreatedTimestamp": number,
   "SendingStatus": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TenantArn": "string",
   "TenantId": "string",
   "TenantName": "string"
}
```

## Response Elements
<a name="API_CreateTenant_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CreatedTimestamp](#API_CreateTenant_ResponseSyntax) **   <a name="SES-CreateTenant-response-CreatedTimestamp"></a>
The date and time when the tenant was created.  
Type: Timestamp

 ** [SendingStatus](#API_CreateTenant_ResponseSyntax) **   <a name="SES-CreateTenant-response-SendingStatus"></a>
The status of email sending capability for the tenant.  
Type: String  
Valid Values: `ENABLED | REINSTATED | DISABLED` 

 ** [Tags](#API_CreateTenant_ResponseSyntax) **   <a name="SES-CreateTenant-response-Tags"></a>
An array of objects that define the tags (keys and values) associated with the tenant.  
Type: Array of [Tag](API_Tag.md) objects

 ** [TenantArn](#API_CreateTenant_ResponseSyntax) **   <a name="SES-CreateTenant-response-TenantArn"></a>
The Amazon Resource Name (ARN) of the tenant.  
Type: String  
Length Constraints: Minimum length of 1.

 ** [TenantId](#API_CreateTenant_ResponseSyntax) **   <a name="SES-CreateTenant-response-TenantId"></a>
A unique identifier for the tenant.  
Type: String

 ** [TenantName](#API_CreateTenant_ResponseSyntax) **   <a name="SES-CreateTenant-response-TenantName"></a>
The name of the tenant.  
Type: String  
Length Constraints: Minimum length of 1.

## Errors
<a name="API_CreateTenant_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateTenant_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateTenant) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateTenant) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateTenant) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateTenant) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateTenant) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateTenant) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateTenant) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateTenant) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateTenant) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateTenant) 

# CreateTenantResourceAssociation
<a name="API_CreateTenantResourceAssociation"></a>

Associate a resource with a tenant.

 *Resources* can be email identities, configuration sets, or email templates. When you associate a resource with a tenant, you can use that resource when sending emails on behalf of that tenant.

A single resource can be associated with multiple tenants, allowing for resource sharing across different tenants while maintaining isolation in email sending operations.

## Request Syntax
<a name="API_CreateTenantResourceAssociation_RequestSyntax"></a>

```
POST /v2/email/tenants/resources HTTP/1.1
Content-type: application/json

{
   "ResourceArn": "string",
   "TenantName": "string"
}
```

## URI Request Parameters
<a name="API_CreateTenantResourceAssociation_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateTenantResourceAssociation_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ResourceArn](#API_CreateTenantResourceAssociation_RequestSyntax) **   <a name="SES-CreateTenantResourceAssociation-request-ResourceArn"></a>
The Amazon Resource Name (ARN) of the resource to associate with the tenant.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [TenantName](#API_CreateTenantResourceAssociation_RequestSyntax) **   <a name="SES-CreateTenantResourceAssociation-request-TenantName"></a>
The name of the tenant to associate the resource with.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_CreateTenantResourceAssociation_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_CreateTenantResourceAssociation_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_CreateTenantResourceAssociation_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_CreateTenantResourceAssociation_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/CreateTenantResourceAssociation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/CreateTenantResourceAssociation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CreateTenantResourceAssociation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/CreateTenantResourceAssociation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateTenantResourceAssociation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/CreateTenantResourceAssociation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/CreateTenantResourceAssociation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/CreateTenantResourceAssociation) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateTenantResourceAssociation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CreateTenantResourceAssociation) 

# DeleteConfigurationSet
<a name="API_DeleteConfigurationSet"></a>

Delete an existing configuration set.

 *Configuration sets* are groups of rules that you can apply to the emails you send. You apply a configuration set to an email by including a reference to the configuration set in the headers of the email. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.

## Request Syntax
<a name="API_DeleteConfigurationSet_RequestSyntax"></a>

```
DELETE /v2/email/configuration-sets/ConfigurationSetName HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteConfigurationSet_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_DeleteConfigurationSet_RequestSyntax) **   <a name="SES-DeleteConfigurationSet-request-uri-ConfigurationSetName"></a>
The name of the configuration set.  
Required: Yes

## Request Body
<a name="API_DeleteConfigurationSet_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteConfigurationSet_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteConfigurationSet_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteConfigurationSet_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteConfigurationSet_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteConfigurationSet) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteConfigurationSet) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteConfigurationSet) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteConfigurationSet) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteConfigurationSet) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteConfigurationSet) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteConfigurationSet) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteConfigurationSet) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteConfigurationSet) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteConfigurationSet) 

# DeleteConfigurationSetEventDestination
<a name="API_DeleteConfigurationSetEventDestination"></a>

Delete an event destination.

 *Events* include message sends, deliveries, opens, clicks, bounces, and complaints. *Event destinations* are places that you can send information about these events to. For example, you can send event data to Amazon EventBridge and associate a rule to send the event to the specified target.

## Request Syntax
<a name="API_DeleteConfigurationSetEventDestination_RequestSyntax"></a>

```
DELETE /v2/email/configuration-sets/ConfigurationSetName/event-destinations/EventDestinationName HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteConfigurationSetEventDestination_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_DeleteConfigurationSetEventDestination_RequestSyntax) **   <a name="SES-DeleteConfigurationSetEventDestination-request-uri-ConfigurationSetName"></a>
The name of the configuration set that contains the event destination to delete.  
Required: Yes

 ** [EventDestinationName](#API_DeleteConfigurationSetEventDestination_RequestSyntax) **   <a name="SES-DeleteConfigurationSetEventDestination-request-uri-EventDestinationName"></a>
The name of the event destination to delete.  
Required: Yes

## Request Body
<a name="API_DeleteConfigurationSetEventDestination_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteConfigurationSetEventDestination_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteConfigurationSetEventDestination_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteConfigurationSetEventDestination_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteConfigurationSetEventDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteConfigurationSetEventDestination) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteConfigurationSetEventDestination) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteConfigurationSetEventDestination) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteConfigurationSetEventDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteConfigurationSetEventDestination) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteConfigurationSetEventDestination) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteConfigurationSetEventDestination) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteConfigurationSetEventDestination) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteConfigurationSetEventDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteConfigurationSetEventDestination) 

# DeleteContact
<a name="API_DeleteContact"></a>

Removes a contact from a contact list.

## Request Syntax
<a name="API_DeleteContact_RequestSyntax"></a>

```
DELETE /v2/email/contact-lists/ContactListName/contacts/EmailAddress HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteContact_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ContactListName](#API_DeleteContact_RequestSyntax) **   <a name="SES-DeleteContact-request-uri-ContactListName"></a>
The name of the contact list from which the contact should be removed.  
Required: Yes

 ** [EmailAddress](#API_DeleteContact_RequestSyntax) **   <a name="SES-DeleteContact-request-uri-EmailAddress"></a>
The contact's email address.  
Required: Yes

## Request Body
<a name="API_DeleteContact_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteContact_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteContact_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteContact_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteContact_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteContact) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteContact) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteContact) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteContact) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteContact) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteContact) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteContact) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteContact) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteContact) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteContact) 

# DeleteContactList
<a name="API_DeleteContactList"></a>

Deletes a contact list and all of the contacts on that list.

## Request Syntax
<a name="API_DeleteContactList_RequestSyntax"></a>

```
DELETE /v2/email/contact-lists/ContactListName HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteContactList_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ContactListName](#API_DeleteContactList_RequestSyntax) **   <a name="SES-DeleteContactList-request-uri-ContactListName"></a>
The name of the contact list.  
Required: Yes

## Request Body
<a name="API_DeleteContactList_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteContactList_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteContactList_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteContactList_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteContactList_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteContactList) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteContactList) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteContactList) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteContactList) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteContactList) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteContactList) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteContactList) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteContactList) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteContactList) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteContactList) 

# DeleteCustomVerificationEmailTemplate
<a name="API_DeleteCustomVerificationEmailTemplate"></a>

Deletes an existing custom verification email template.

For more information about custom verification email templates, see [Using custom verification email templates](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) in the *Amazon SES Developer Guide*.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_DeleteCustomVerificationEmailTemplate_RequestSyntax"></a>

```
DELETE /v2/email/custom-verification-email-templates/TemplateName HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteCustomVerificationEmailTemplate_RequestParameters"></a>

The request uses the following URI parameters.

 ** [TemplateName](#API_DeleteCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-DeleteCustomVerificationEmailTemplate-request-uri-TemplateName"></a>
The name of the custom verification email template that you want to delete.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_DeleteCustomVerificationEmailTemplate_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteCustomVerificationEmailTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteCustomVerificationEmailTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteCustomVerificationEmailTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteCustomVerificationEmailTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteCustomVerificationEmailTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteCustomVerificationEmailTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteCustomVerificationEmailTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteCustomVerificationEmailTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteCustomVerificationEmailTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteCustomVerificationEmailTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteCustomVerificationEmailTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteCustomVerificationEmailTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteCustomVerificationEmailTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteCustomVerificationEmailTemplate) 

# DeleteDedicatedIpPool
<a name="API_DeleteDedicatedIpPool"></a>

Delete a dedicated IP pool.

## Request Syntax
<a name="API_DeleteDedicatedIpPool_RequestSyntax"></a>

```
DELETE /v2/email/dedicated-ip-pools/PoolName HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteDedicatedIpPool_RequestParameters"></a>

The request uses the following URI parameters.

 ** [PoolName](#API_DeleteDedicatedIpPool_RequestSyntax) **   <a name="SES-DeleteDedicatedIpPool-request-uri-PoolName"></a>
The name of the dedicated IP pool that you want to delete.  
Required: Yes

## Request Body
<a name="API_DeleteDedicatedIpPool_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteDedicatedIpPool_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteDedicatedIpPool_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteDedicatedIpPool_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteDedicatedIpPool_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteDedicatedIpPool) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteDedicatedIpPool) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteDedicatedIpPool) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteDedicatedIpPool) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteDedicatedIpPool) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteDedicatedIpPool) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteDedicatedIpPool) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteDedicatedIpPool) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteDedicatedIpPool) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteDedicatedIpPool) 

# DeleteEmailIdentity
<a name="API_DeleteEmailIdentity"></a>

Deletes an email identity. An identity can be either an email address or a domain name.

## Request Syntax
<a name="API_DeleteEmailIdentity_RequestSyntax"></a>

```
DELETE /v2/email/identities/EmailIdentity HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteEmailIdentity_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailIdentity](#API_DeleteEmailIdentity_RequestSyntax) **   <a name="SES-DeleteEmailIdentity-request-uri-EmailIdentity"></a>
The identity (that is, the email address or domain) to delete.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_DeleteEmailIdentity_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteEmailIdentity_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteEmailIdentity_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteEmailIdentity_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteEmailIdentity_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteEmailIdentity) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteEmailIdentity) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteEmailIdentity) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteEmailIdentity) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteEmailIdentity) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteEmailIdentity) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteEmailIdentity) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteEmailIdentity) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteEmailIdentity) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteEmailIdentity) 

# DeleteEmailIdentityPolicy
<a name="API_DeleteEmailIdentityPolicy"></a>

Deletes the specified sending authorization policy for the given identity (an email address or a domain). This API returns successfully even if a policy with the specified name does not exist.

**Note**  
This API is for the identity owner only. If you have not verified the identity, this API will return an error.

Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html).

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_DeleteEmailIdentityPolicy_RequestSyntax"></a>

```
DELETE /v2/email/identities/EmailIdentity/policies/PolicyName HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteEmailIdentityPolicy_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailIdentity](#API_DeleteEmailIdentityPolicy_RequestSyntax) **   <a name="SES-DeleteEmailIdentityPolicy-request-uri-EmailIdentity"></a>
The email identity.  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [PolicyName](#API_DeleteEmailIdentityPolicy_RequestSyntax) **   <a name="SES-DeleteEmailIdentityPolicy-request-uri-PolicyName"></a>
The name of the policy.  
The policy name cannot exceed 64 characters and can only include alphanumeric characters, dashes, and underscores.  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Required: Yes

## Request Body
<a name="API_DeleteEmailIdentityPolicy_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteEmailIdentityPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteEmailIdentityPolicy_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteEmailIdentityPolicy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteEmailIdentityPolicy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteEmailIdentityPolicy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteEmailIdentityPolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteEmailIdentityPolicy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteEmailIdentityPolicy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteEmailIdentityPolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteEmailIdentityPolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteEmailIdentityPolicy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteEmailIdentityPolicy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteEmailIdentityPolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteEmailIdentityPolicy) 

# DeleteEmailTemplate
<a name="API_DeleteEmailTemplate"></a>

Deletes an email template.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_DeleteEmailTemplate_RequestSyntax"></a>

```
DELETE /v2/email/templates/TemplateName HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteEmailTemplate_RequestParameters"></a>

The request uses the following URI parameters.

 ** [TemplateName](#API_DeleteEmailTemplate_RequestSyntax) **   <a name="SES-DeleteEmailTemplate-request-uri-TemplateName"></a>
The name of the template to be deleted.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_DeleteEmailTemplate_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteEmailTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteEmailTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteEmailTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteEmailTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteEmailTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteEmailTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteEmailTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteEmailTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteEmailTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteEmailTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteEmailTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteEmailTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteEmailTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteEmailTemplate) 

# DeleteMultiRegionEndpoint
<a name="API_DeleteMultiRegionEndpoint"></a>

Deletes a multi-region endpoint (global-endpoint).

Only multi-region endpoints (global-endpoints) whose primary region is the AWS-Region where operation is executed can be deleted.

## Request Syntax
<a name="API_DeleteMultiRegionEndpoint_RequestSyntax"></a>

```
DELETE /v2/email/multi-region-endpoints/EndpointName HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteMultiRegionEndpoint_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EndpointName](#API_DeleteMultiRegionEndpoint_RequestSyntax) **   <a name="SES-DeleteMultiRegionEndpoint-request-uri-EndpointName"></a>
The name of the multi-region endpoint (global-endpoint) to be deleted.  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `^[\w\-_]+$`   
Required: Yes

## Request Body
<a name="API_DeleteMultiRegionEndpoint_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteMultiRegionEndpoint_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Status": "string"
}
```

## Response Elements
<a name="API_DeleteMultiRegionEndpoint_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Status](#API_DeleteMultiRegionEndpoint_ResponseSyntax) **   <a name="SES-DeleteMultiRegionEndpoint-response-Status"></a>
A status of the multi-region endpoint (global-endpoint) right after the delete request.  
+  `CREATING` – The resource is being provisioned.
+  `READY` – The resource is ready to use.
+  `FAILED` – The resource failed to be provisioned.
+  `DELETING` – The resource is being deleted as requested.
Type: String  
Valid Values: `CREATING | READY | FAILED | DELETING` 

## Errors
<a name="API_DeleteMultiRegionEndpoint_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteMultiRegionEndpoint_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteMultiRegionEndpoint) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteMultiRegionEndpoint) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteMultiRegionEndpoint) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteMultiRegionEndpoint) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteMultiRegionEndpoint) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteMultiRegionEndpoint) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteMultiRegionEndpoint) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteMultiRegionEndpoint) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteMultiRegionEndpoint) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteMultiRegionEndpoint) 

# DeleteSuppressedDestination
<a name="API_DeleteSuppressedDestination"></a>

Removes an email address from the suppression list for your account.

## Request Syntax
<a name="API_DeleteSuppressedDestination_RequestSyntax"></a>

```
DELETE /v2/email/suppression/addresses/EmailAddress HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteSuppressedDestination_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailAddress](#API_DeleteSuppressedDestination_RequestSyntax) **   <a name="SES-DeleteSuppressedDestination-request-uri-EmailAddress"></a>
The suppressed email destination to remove from the account suppression list.  
Required: Yes

## Request Body
<a name="API_DeleteSuppressedDestination_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteSuppressedDestination_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteSuppressedDestination_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteSuppressedDestination_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteSuppressedDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteSuppressedDestination) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteSuppressedDestination) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteSuppressedDestination) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteSuppressedDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteSuppressedDestination) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteSuppressedDestination) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteSuppressedDestination) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteSuppressedDestination) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteSuppressedDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteSuppressedDestination) 

# DeleteTenant
<a name="API_DeleteTenant"></a>

Delete an existing tenant.

When you delete a tenant, its associations with resources are removed, but the resources themselves are not deleted.

## Request Syntax
<a name="API_DeleteTenant_RequestSyntax"></a>

```
POST /v2/email/tenants/delete HTTP/1.1
Content-type: application/json

{
   "TenantName": "string"
}
```

## URI Request Parameters
<a name="API_DeleteTenant_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteTenant_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [TenantName](#API_DeleteTenant_RequestSyntax) **   <a name="SES-DeleteTenant-request-TenantName"></a>
The name of the tenant to delete.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_DeleteTenant_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteTenant_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteTenant_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteTenant_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteTenant) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteTenant) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteTenant) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteTenant) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteTenant) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteTenant) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteTenant) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteTenant) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteTenant) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteTenant) 

# DeleteTenantResourceAssociation
<a name="API_DeleteTenantResourceAssociation"></a>

Delete an association between a tenant and a resource.

When you delete a tenant-resource association, the resource itself is not deleted, only its association with the specific tenant is removed. After removal, the resource will no longer be available for use with that tenant's email sending operations.

## Request Syntax
<a name="API_DeleteTenantResourceAssociation_RequestSyntax"></a>

```
POST /v2/email/tenants/resources/delete HTTP/1.1
Content-type: application/json

{
   "ResourceArn": "string",
   "TenantName": "string"
}
```

## URI Request Parameters
<a name="API_DeleteTenantResourceAssociation_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteTenantResourceAssociation_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ResourceArn](#API_DeleteTenantResourceAssociation_RequestSyntax) **   <a name="SES-DeleteTenantResourceAssociation-request-ResourceArn"></a>
The Amazon Resource Name (ARN) of the resource to remove from the tenant association.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [TenantName](#API_DeleteTenantResourceAssociation_RequestSyntax) **   <a name="SES-DeleteTenantResourceAssociation-request-TenantName"></a>
The name of the tenant to remove the resource association from.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_DeleteTenantResourceAssociation_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteTenantResourceAssociation_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteTenantResourceAssociation_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_DeleteTenantResourceAssociation_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/DeleteTenantResourceAssociation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/DeleteTenantResourceAssociation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeleteTenantResourceAssociation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/DeleteTenantResourceAssociation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteTenantResourceAssociation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/DeleteTenantResourceAssociation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/DeleteTenantResourceAssociation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/DeleteTenantResourceAssociation) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/DeleteTenantResourceAssociation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeleteTenantResourceAssociation) 

# GetAccount
<a name="API_GetAccount"></a>

Obtain information about the email-sending status and capabilities of your Amazon SES account in the current AWS Region.

## Request Syntax
<a name="API_GetAccount_RequestSyntax"></a>

```
GET /v2/email/account HTTP/1.1
```

## URI Request Parameters
<a name="API_GetAccount_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_GetAccount_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetAccount_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DedicatedIpAutoWarmupEnabled": boolean,
   "Details": { 
      "AdditionalContactEmailAddresses": [ "string" ],
      "ContactLanguage": "string",
      "MailType": "string",
      "ReviewDetails": { 
         "CaseId": "string",
         "Status": "string"
      },
      "UseCaseDescription": "string",
      "WebsiteURL": "string"
   },
   "EnforcementStatus": "string",
   "ProductionAccessEnabled": boolean,
   "SendingEnabled": boolean,
   "SendQuota": { 
      "Max24HourSend": number,
      "MaxSendRate": number,
      "SentLast24Hours": number
   },
   "SuppressionAttributes": { 
      "SuppressedReasons": [ "string" ],
      "ValidationAttributes": { 
         "ConditionThreshold": { 
            "ConditionThresholdEnabled": "string",
            "OverallConfidenceThreshold": { 
               "ConfidenceVerdictThreshold": "string"
            }
         }
      }
   },
   "VdmAttributes": { 
      "DashboardAttributes": { 
         "EngagementMetrics": "string"
      },
      "GuardianAttributes": { 
         "OptimizedSharedDelivery": "string"
      },
      "VdmEnabled": "string"
   }
}
```

## Response Elements
<a name="API_GetAccount_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DedicatedIpAutoWarmupEnabled](#API_GetAccount_ResponseSyntax) **   <a name="SES-GetAccount-response-DedicatedIpAutoWarmupEnabled"></a>
Indicates whether or not the automatic warm-up feature is enabled for dedicated IP addresses that are associated with your account.  
Type: Boolean

 ** [Details](#API_GetAccount_ResponseSyntax) **   <a name="SES-GetAccount-response-Details"></a>
An object that defines your account details.  
Type: [AccountDetails](API_AccountDetails.md) object

 ** [EnforcementStatus](#API_GetAccount_ResponseSyntax) **   <a name="SES-GetAccount-response-EnforcementStatus"></a>
The reputation status of your Amazon SES account. The status can be one of the following:  
+  `HEALTHY` – There are no reputation-related issues that currently impact your account.
+  `PROBATION` – We've identified potential issues with your Amazon SES account. We're placing your account under review while you work on correcting these issues.
+  `SHUTDOWN` – Your account's ability to send email is currently paused because of an issue with the email sent from your account. When you correct the issue, you can contact us and request that your account's ability to send email is resumed.
Type: String

 ** [ProductionAccessEnabled](#API_GetAccount_ResponseSyntax) **   <a name="SES-GetAccount-response-ProductionAccessEnabled"></a>
Indicates whether or not your account has production access in the current AWS Region.  
If the value is `false`, then your account is in the *sandbox*. When your account is in the sandbox, you can only send email to verified identities.   
If the value is `true`, then your account has production access. When your account has production access, you can send email to any address. The sending quota and maximum sending rate for your account vary based on your specific use case.  
Type: Boolean

 ** [SendingEnabled](#API_GetAccount_ResponseSyntax) **   <a name="SES-GetAccount-response-SendingEnabled"></a>
Indicates whether or not email sending is enabled for your Amazon SES account in the current AWS Region.  
Type: Boolean

 ** [SendQuota](#API_GetAccount_ResponseSyntax) **   <a name="SES-GetAccount-response-SendQuota"></a>
An object that contains information about the per-day and per-second sending limits for your Amazon SES account in the current AWS Region.  
Type: [SendQuota](API_SendQuota.md) object

 ** [SuppressionAttributes](#API_GetAccount_ResponseSyntax) **   <a name="SES-GetAccount-response-SuppressionAttributes"></a>
An object that contains information about the email address suppression preferences for your account in the current AWS Region.  
Type: [SuppressionAttributes](API_SuppressionAttributes.md) object

 ** [VdmAttributes](#API_GetAccount_ResponseSyntax) **   <a name="SES-GetAccount-response-VdmAttributes"></a>
The VDM attributes that apply to your Amazon SES account.  
Type: [VdmAttributes](API_VdmAttributes.md) object

## Errors
<a name="API_GetAccount_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetAccount_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetAccount) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetAccount) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetAccount) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetAccount) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetAccount) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetAccount) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetAccount) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetAccount) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetAccount) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetAccount) 

# GetBlacklistReports
<a name="API_GetBlacklistReports"></a>

Retrieve a list of the blacklists that your dedicated IP addresses appear on.

## Request Syntax
<a name="API_GetBlacklistReports_RequestSyntax"></a>

```
GET /v2/email/deliverability-dashboard/blacklist-report?BlacklistItemNames=BlacklistItemNames HTTP/1.1
```

## URI Request Parameters
<a name="API_GetBlacklistReports_RequestParameters"></a>

The request uses the following URI parameters.

 ** [BlacklistItemNames](#API_GetBlacklistReports_RequestSyntax) **   <a name="SES-GetBlacklistReports-request-uri-BlacklistItemNames"></a>
A list of IP addresses that you want to retrieve blacklist information about. You can only specify the dedicated IP addresses that you use to send email using Amazon SES or Amazon Pinpoint.  
Required: Yes

## Request Body
<a name="API_GetBlacklistReports_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetBlacklistReports_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BlacklistReport": { 
      "string" : [ 
         { 
            "Description": "string",
            "ListingTime": number,
            "RblName": "string"
         }
      ]
   }
}
```

## Response Elements
<a name="API_GetBlacklistReports_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [BlacklistReport](#API_GetBlacklistReports_ResponseSyntax) **   <a name="SES-GetBlacklistReports-response-BlacklistReport"></a>
An object that contains information about a blacklist that one of your dedicated IP addresses appears on.  
Type: String to array of [BlacklistEntry](API_BlacklistEntry.md) objects map

## Errors
<a name="API_GetBlacklistReports_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetBlacklistReports_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetBlacklistReports) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetBlacklistReports) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetBlacklistReports) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetBlacklistReports) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetBlacklistReports) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetBlacklistReports) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetBlacklistReports) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetBlacklistReports) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetBlacklistReports) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetBlacklistReports) 

# GetConfigurationSet
<a name="API_GetConfigurationSet"></a>

Get information about an existing configuration set, including the dedicated IP pool that it's associated with, whether or not it's enabled for sending email, and more.

 *Configuration sets* are groups of rules that you can apply to the emails you send. You apply a configuration set to an email by including a reference to the configuration set in the headers of the email. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.

## Request Syntax
<a name="API_GetConfigurationSet_RequestSyntax"></a>

```
GET /v2/email/configuration-sets/ConfigurationSetName HTTP/1.1
```

## URI Request Parameters
<a name="API_GetConfigurationSet_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_GetConfigurationSet_RequestSyntax) **   <a name="SES-GetConfigurationSet-request-uri-ConfigurationSetName"></a>
The name of the configuration set.  
Required: Yes

## Request Body
<a name="API_GetConfigurationSet_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetConfigurationSet_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ArchivingOptions": { 
      "ArchiveArn": "string"
   },
   "ConfigurationSetName": "string",
   "DeliveryOptions": { 
      "MaxDeliverySeconds": number,
      "SendingPoolName": "string",
      "TlsPolicy": "string"
   },
   "ReputationOptions": { 
      "LastFreshStart": number,
      "ReputationMetricsEnabled": boolean
   },
   "SendingOptions": { 
      "SendingEnabled": boolean
   },
   "SuppressionOptions": { 
      "SuppressedReasons": [ "string" ],
      "ValidationOptions": { 
         "ConditionThreshold": { 
            "ConditionThresholdEnabled": "string",
            "OverallConfidenceThreshold": { 
               "ConfidenceVerdictThreshold": "string"
            }
         }
      }
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TrackingOptions": { 
      "CustomRedirectDomain": "string",
      "HttpsPolicy": "string"
   },
   "VdmOptions": { 
      "DashboardOptions": { 
         "EngagementMetrics": "string"
      },
      "GuardianOptions": { 
         "OptimizedSharedDelivery": "string"
      }
   }
}
```

## Response Elements
<a name="API_GetConfigurationSet_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ArchivingOptions](#API_GetConfigurationSet_ResponseSyntax) **   <a name="SES-GetConfigurationSet-response-ArchivingOptions"></a>
An object that defines the MailManager archive where sent emails are archived that you send using the configuration set.  
Type: [ArchivingOptions](API_ArchivingOptions.md) object

 ** [ConfigurationSetName](#API_GetConfigurationSet_ResponseSyntax) **   <a name="SES-GetConfigurationSet-response-ConfigurationSetName"></a>
The name of the configuration set.  
Type: String

 ** [DeliveryOptions](#API_GetConfigurationSet_ResponseSyntax) **   <a name="SES-GetConfigurationSet-response-DeliveryOptions"></a>
An object that defines the dedicated IP pool that is used to send emails that you send using the configuration set.  
Type: [DeliveryOptions](API_DeliveryOptions.md) object

 ** [ReputationOptions](#API_GetConfigurationSet_ResponseSyntax) **   <a name="SES-GetConfigurationSet-response-ReputationOptions"></a>
An object that defines whether or not Amazon SES collects reputation metrics for the emails that you send that use the configuration set.  
Type: [ReputationOptions](API_ReputationOptions.md) object

 ** [SendingOptions](#API_GetConfigurationSet_ResponseSyntax) **   <a name="SES-GetConfigurationSet-response-SendingOptions"></a>
An object that defines whether or not Amazon SES can send email that you send using the configuration set.  
Type: [SendingOptions](API_SendingOptions.md) object

 ** [SuppressionOptions](#API_GetConfigurationSet_ResponseSyntax) **   <a name="SES-GetConfigurationSet-response-SuppressionOptions"></a>
An object that contains information about the suppression list preferences for your account.  
Type: [SuppressionOptions](API_SuppressionOptions.md) object

 ** [Tags](#API_GetConfigurationSet_ResponseSyntax) **   <a name="SES-GetConfigurationSet-response-Tags"></a>
An array of objects that define the tags (keys and values) that are associated with the configuration set.  
Type: Array of [Tag](API_Tag.md) objects

 ** [TrackingOptions](#API_GetConfigurationSet_ResponseSyntax) **   <a name="SES-GetConfigurationSet-response-TrackingOptions"></a>
An object that defines the open and click tracking options for emails that you send using the configuration set.  
Type: [TrackingOptions](API_TrackingOptions.md) object

 ** [VdmOptions](#API_GetConfigurationSet_ResponseSyntax) **   <a name="SES-GetConfigurationSet-response-VdmOptions"></a>
An object that contains information about the VDM preferences for your configuration set.  
Type: [VdmOptions](API_VdmOptions.md) object

## Errors
<a name="API_GetConfigurationSet_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetConfigurationSet_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetConfigurationSet) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetConfigurationSet) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetConfigurationSet) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetConfigurationSet) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetConfigurationSet) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetConfigurationSet) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetConfigurationSet) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetConfigurationSet) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetConfigurationSet) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetConfigurationSet) 

# GetConfigurationSetEventDestinations
<a name="API_GetConfigurationSetEventDestinations"></a>

Retrieve a list of event destinations that are associated with a configuration set.

 *Events* include message sends, deliveries, opens, clicks, bounces, and complaints. *Event destinations* are places that you can send information about these events to. For example, you can send event data to Amazon EventBridge and associate a rule to send the event to the specified target.

## Request Syntax
<a name="API_GetConfigurationSetEventDestinations_RequestSyntax"></a>

```
GET /v2/email/configuration-sets/ConfigurationSetName/event-destinations HTTP/1.1
```

## URI Request Parameters
<a name="API_GetConfigurationSetEventDestinations_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_GetConfigurationSetEventDestinations_RequestSyntax) **   <a name="SES-GetConfigurationSetEventDestinations-request-uri-ConfigurationSetName"></a>
The name of the configuration set that contains the event destination.  
Required: Yes

## Request Body
<a name="API_GetConfigurationSetEventDestinations_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetConfigurationSetEventDestinations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "EventDestinations": [ 
      { 
         "CloudWatchDestination": { 
            "DimensionConfigurations": [ 
               { 
                  "DefaultDimensionValue": "string",
                  "DimensionName": "string",
                  "DimensionValueSource": "string"
               }
            ]
         },
         "Enabled": boolean,
         "EventBridgeDestination": { 
            "EventBusArn": "string"
         },
         "KinesisFirehoseDestination": { 
            "DeliveryStreamArn": "string",
            "IamRoleArn": "string"
         },
         "MatchingEventTypes": [ "string" ],
         "Name": "string",
         "PinpointDestination": { 
            "ApplicationArn": "string"
         },
         "SnsDestination": { 
            "TopicArn": "string"
         }
      }
   ]
}
```

## Response Elements
<a name="API_GetConfigurationSetEventDestinations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [EventDestinations](#API_GetConfigurationSetEventDestinations_ResponseSyntax) **   <a name="SES-GetConfigurationSetEventDestinations-response-EventDestinations"></a>
An array that includes all of the events destinations that have been configured for the configuration set.  
Type: Array of [EventDestination](API_EventDestination.md) objects

## Errors
<a name="API_GetConfigurationSetEventDestinations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetConfigurationSetEventDestinations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetConfigurationSetEventDestinations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetConfigurationSetEventDestinations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetConfigurationSetEventDestinations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetConfigurationSetEventDestinations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetConfigurationSetEventDestinations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetConfigurationSetEventDestinations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetConfigurationSetEventDestinations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetConfigurationSetEventDestinations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetConfigurationSetEventDestinations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetConfigurationSetEventDestinations) 

# GetContact
<a name="API_GetContact"></a>

Returns a contact from a contact list.

## Request Syntax
<a name="API_GetContact_RequestSyntax"></a>

```
GET /v2/email/contact-lists/ContactListName/contacts/EmailAddress HTTP/1.1
```

## URI Request Parameters
<a name="API_GetContact_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ContactListName](#API_GetContact_RequestSyntax) **   <a name="SES-GetContact-request-uri-ContactListName"></a>
The name of the contact list to which the contact belongs.  
Required: Yes

 ** [EmailAddress](#API_GetContact_RequestSyntax) **   <a name="SES-GetContact-request-uri-EmailAddress"></a>
The contact's email address.  
Required: Yes

## Request Body
<a name="API_GetContact_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetContact_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AttributesData": "string",
   "ContactListName": "string",
   "CreatedTimestamp": number,
   "EmailAddress": "string",
   "LastUpdatedTimestamp": number,
   "TopicDefaultPreferences": [ 
      { 
         "SubscriptionStatus": "string",
         "TopicName": "string"
      }
   ],
   "TopicPreferences": [ 
      { 
         "SubscriptionStatus": "string",
         "TopicName": "string"
      }
   ],
   "UnsubscribeAll": boolean
}
```

## Response Elements
<a name="API_GetContact_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AttributesData](#API_GetContact_ResponseSyntax) **   <a name="SES-GetContact-response-AttributesData"></a>
The attribute data attached to a contact.  
Type: String

 ** [ContactListName](#API_GetContact_ResponseSyntax) **   <a name="SES-GetContact-response-ContactListName"></a>
The name of the contact list to which the contact belongs.  
Type: String

 ** [CreatedTimestamp](#API_GetContact_ResponseSyntax) **   <a name="SES-GetContact-response-CreatedTimestamp"></a>
A timestamp noting when the contact was created.  
Type: Timestamp

 ** [EmailAddress](#API_GetContact_ResponseSyntax) **   <a name="SES-GetContact-response-EmailAddress"></a>
The contact's email address.  
Type: String

 ** [LastUpdatedTimestamp](#API_GetContact_ResponseSyntax) **   <a name="SES-GetContact-response-LastUpdatedTimestamp"></a>
A timestamp noting the last time the contact's information was updated.  
Type: Timestamp

 ** [TopicDefaultPreferences](#API_GetContact_ResponseSyntax) **   <a name="SES-GetContact-response-TopicDefaultPreferences"></a>
The default topic preferences applied to the contact.  
Type: Array of [TopicPreference](API_TopicPreference.md) objects

 ** [TopicPreferences](#API_GetContact_ResponseSyntax) **   <a name="SES-GetContact-response-TopicPreferences"></a>
The contact's preference for being opted-in to or opted-out of a topic.>  
Type: Array of [TopicPreference](API_TopicPreference.md) objects

 ** [UnsubscribeAll](#API_GetContact_ResponseSyntax) **   <a name="SES-GetContact-response-UnsubscribeAll"></a>
A boolean value status noting if the contact is unsubscribed from all contact list topics.  
Type: Boolean

## Errors
<a name="API_GetContact_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetContact_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetContact) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetContact) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetContact) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetContact) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetContact) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetContact) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetContact) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetContact) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetContact) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetContact) 

# GetContactList
<a name="API_GetContactList"></a>

Returns contact list metadata. It does not return any information about the contacts present in the list.

## Request Syntax
<a name="API_GetContactList_RequestSyntax"></a>

```
GET /v2/email/contact-lists/ContactListName HTTP/1.1
```

## URI Request Parameters
<a name="API_GetContactList_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ContactListName](#API_GetContactList_RequestSyntax) **   <a name="SES-GetContactList-request-uri-ContactListName"></a>
The name of the contact list.  
Required: Yes

## Request Body
<a name="API_GetContactList_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetContactList_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ContactListName": "string",
   "CreatedTimestamp": number,
   "Description": "string",
   "LastUpdatedTimestamp": number,
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "Topics": [ 
      { 
         "DefaultSubscriptionStatus": "string",
         "Description": "string",
         "DisplayName": "string",
         "TopicName": "string"
      }
   ]
}
```

## Response Elements
<a name="API_GetContactList_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ContactListName](#API_GetContactList_ResponseSyntax) **   <a name="SES-GetContactList-response-ContactListName"></a>
The name of the contact list.  
Type: String

 ** [CreatedTimestamp](#API_GetContactList_ResponseSyntax) **   <a name="SES-GetContactList-response-CreatedTimestamp"></a>
A timestamp noting when the contact list was created.  
Type: Timestamp

 ** [Description](#API_GetContactList_ResponseSyntax) **   <a name="SES-GetContactList-response-Description"></a>
A description of what the contact list is about.  
Type: String

 ** [LastUpdatedTimestamp](#API_GetContactList_ResponseSyntax) **   <a name="SES-GetContactList-response-LastUpdatedTimestamp"></a>
A timestamp noting the last time the contact list was updated.  
Type: Timestamp

 ** [Tags](#API_GetContactList_ResponseSyntax) **   <a name="SES-GetContactList-response-Tags"></a>
The tags associated with a contact list.  
Type: Array of [Tag](API_Tag.md) objects

 ** [Topics](#API_GetContactList_ResponseSyntax) **   <a name="SES-GetContactList-response-Topics"></a>
An interest group, theme, or label within a list. A contact list can have multiple topics.  
Type: Array of [Topic](API_Topic.md) objects

## Errors
<a name="API_GetContactList_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetContactList_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetContactList) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetContactList) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetContactList) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetContactList) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetContactList) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetContactList) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetContactList) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetContactList) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetContactList) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetContactList) 

# GetCustomVerificationEmailTemplate
<a name="API_GetCustomVerificationEmailTemplate"></a>

Returns the custom email verification template for the template name you specify.

For more information about custom verification email templates, see [Using custom verification email templates](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) in the *Amazon SES Developer Guide*.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_GetCustomVerificationEmailTemplate_RequestSyntax"></a>

```
GET /v2/email/custom-verification-email-templates/TemplateName HTTP/1.1
```

## URI Request Parameters
<a name="API_GetCustomVerificationEmailTemplate_RequestParameters"></a>

The request uses the following URI parameters.

 ** [TemplateName](#API_GetCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-GetCustomVerificationEmailTemplate-request-uri-TemplateName"></a>
The name of the custom verification email template that you want to retrieve.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_GetCustomVerificationEmailTemplate_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetCustomVerificationEmailTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FailureRedirectionURL": "string",
   "FromEmailAddress": "string",
   "SuccessRedirectionURL": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TemplateContent": "string",
   "TemplateName": "string",
   "TemplateSubject": "string"
}
```

## Response Elements
<a name="API_GetCustomVerificationEmailTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [FailureRedirectionURL](#API_GetCustomVerificationEmailTemplate_ResponseSyntax) **   <a name="SES-GetCustomVerificationEmailTemplate-response-FailureRedirectionURL"></a>
The URL that the recipient of the verification email is sent to if his or her address is not successfully verified.  
Type: String

 ** [FromEmailAddress](#API_GetCustomVerificationEmailTemplate_ResponseSyntax) **   <a name="SES-GetCustomVerificationEmailTemplate-response-FromEmailAddress"></a>
The email address that the custom verification email is sent from.  
Type: String

 ** [SuccessRedirectionURL](#API_GetCustomVerificationEmailTemplate_ResponseSyntax) **   <a name="SES-GetCustomVerificationEmailTemplate-response-SuccessRedirectionURL"></a>
The URL that the recipient of the verification email is sent to if his or her address is successfully verified.  
Type: String

 ** [Tags](#API_GetCustomVerificationEmailTemplate_ResponseSyntax) **   <a name="SES-GetCustomVerificationEmailTemplate-response-Tags"></a>
An array of objects that define the tags (keys and values) that are associated with the custom verification email template.  
Type: Array of [Tag](API_Tag.md) objects

 ** [TemplateContent](#API_GetCustomVerificationEmailTemplate_ResponseSyntax) **   <a name="SES-GetCustomVerificationEmailTemplate-response-TemplateContent"></a>
The content of the custom verification email.  
Type: String

 ** [TemplateName](#API_GetCustomVerificationEmailTemplate_ResponseSyntax) **   <a name="SES-GetCustomVerificationEmailTemplate-response-TemplateName"></a>
The name of the custom verification email template.  
Type: String  
Length Constraints: Minimum length of 1.

 ** [TemplateSubject](#API_GetCustomVerificationEmailTemplate_ResponseSyntax) **   <a name="SES-GetCustomVerificationEmailTemplate-response-TemplateSubject"></a>
The subject line of the custom verification email.  
Type: String

## Errors
<a name="API_GetCustomVerificationEmailTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetCustomVerificationEmailTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetCustomVerificationEmailTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetCustomVerificationEmailTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetCustomVerificationEmailTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetCustomVerificationEmailTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetCustomVerificationEmailTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetCustomVerificationEmailTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetCustomVerificationEmailTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetCustomVerificationEmailTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetCustomVerificationEmailTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetCustomVerificationEmailTemplate) 

# GetDedicatedIp
<a name="API_GetDedicatedIp"></a>

Get information about a dedicated IP address, including the name of the dedicated IP pool that it's associated with, as well information about the automatic warm-up process for the address.

## Request Syntax
<a name="API_GetDedicatedIp_RequestSyntax"></a>

```
GET /v2/email/dedicated-ips/IP HTTP/1.1
```

## URI Request Parameters
<a name="API_GetDedicatedIp_RequestParameters"></a>

The request uses the following URI parameters.

 ** [IP](#API_GetDedicatedIp_RequestSyntax) **   <a name="SES-GetDedicatedIp-request-uri-Ip"></a>
The IP address that you want to obtain more information about. The value you specify has to be a dedicated IP address that's assocaited with your AWS account.  
Required: Yes

## Request Body
<a name="API_GetDedicatedIp_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetDedicatedIp_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DedicatedIp": { 
      "Ip": "string",
      "PoolName": "string",
      "WarmupPercentage": number,
      "WarmupStatus": "string"
   }
}
```

## Response Elements
<a name="API_GetDedicatedIp_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DedicatedIp](#API_GetDedicatedIp_ResponseSyntax) **   <a name="SES-GetDedicatedIp-response-DedicatedIp"></a>
An object that contains information about a dedicated IP address.  
Type: [DedicatedIp](API_DedicatedIp.md) object

## Errors
<a name="API_GetDedicatedIp_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetDedicatedIp_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetDedicatedIp) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetDedicatedIp) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetDedicatedIp) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetDedicatedIp) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetDedicatedIp) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetDedicatedIp) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetDedicatedIp) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetDedicatedIp) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetDedicatedIp) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetDedicatedIp) 

# GetDedicatedIpPool
<a name="API_GetDedicatedIpPool"></a>

Retrieve information about the dedicated pool.

## Request Syntax
<a name="API_GetDedicatedIpPool_RequestSyntax"></a>

```
GET /v2/email/dedicated-ip-pools/PoolName HTTP/1.1
```

## URI Request Parameters
<a name="API_GetDedicatedIpPool_RequestParameters"></a>

The request uses the following URI parameters.

 ** [PoolName](#API_GetDedicatedIpPool_RequestSyntax) **   <a name="SES-GetDedicatedIpPool-request-uri-PoolName"></a>
The name of the dedicated IP pool to retrieve.  
Required: Yes

## Request Body
<a name="API_GetDedicatedIpPool_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetDedicatedIpPool_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DedicatedIpPool": { 
      "PoolName": "string",
      "ScalingMode": "string"
   }
}
```

## Response Elements
<a name="API_GetDedicatedIpPool_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DedicatedIpPool](#API_GetDedicatedIpPool_ResponseSyntax) **   <a name="SES-GetDedicatedIpPool-response-DedicatedIpPool"></a>
An object that contains information about a dedicated IP pool.  
Type: [DedicatedIpPool](API_DedicatedIpPool.md) object

## Errors
<a name="API_GetDedicatedIpPool_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetDedicatedIpPool_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetDedicatedIpPool) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetDedicatedIpPool) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetDedicatedIpPool) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetDedicatedIpPool) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetDedicatedIpPool) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetDedicatedIpPool) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetDedicatedIpPool) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetDedicatedIpPool) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetDedicatedIpPool) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetDedicatedIpPool) 

# GetDedicatedIps
<a name="API_GetDedicatedIps"></a>

List the dedicated IP addresses that are associated with your AWS account.

## Request Syntax
<a name="API_GetDedicatedIps_RequestSyntax"></a>

```
GET /v2/email/dedicated-ips?NextToken=NextToken&PageSize=PageSize&PoolName=PoolName HTTP/1.1
```

## URI Request Parameters
<a name="API_GetDedicatedIps_RequestParameters"></a>

The request uses the following URI parameters.

 ** [NextToken](#API_GetDedicatedIps_RequestSyntax) **   <a name="SES-GetDedicatedIps-request-uri-NextToken"></a>
A token returned from a previous call to `GetDedicatedIps` to indicate the position of the dedicated IP pool in the list of IP pools.

 ** [PageSize](#API_GetDedicatedIps_RequestSyntax) **   <a name="SES-GetDedicatedIps-request-uri-PageSize"></a>
The number of results to show in a single call to `GetDedicatedIpsRequest`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.

 ** [PoolName](#API_GetDedicatedIps_RequestSyntax) **   <a name="SES-GetDedicatedIps-request-uri-PoolName"></a>
The name of the IP pool that the dedicated IP address is associated with.

## Request Body
<a name="API_GetDedicatedIps_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetDedicatedIps_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DedicatedIps": [ 
      { 
         "Ip": "string",
         "PoolName": "string",
         "WarmupPercentage": number,
         "WarmupStatus": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_GetDedicatedIps_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DedicatedIps](#API_GetDedicatedIps_ResponseSyntax) **   <a name="SES-GetDedicatedIps-response-DedicatedIps"></a>
A list of dedicated IP addresses that are associated with your AWS account.  
Type: Array of [DedicatedIp](API_DedicatedIp.md) objects

 ** [NextToken](#API_GetDedicatedIps_ResponseSyntax) **   <a name="SES-GetDedicatedIps-response-NextToken"></a>
A token that indicates that there are additional dedicated IP addresses to list. To view additional addresses, issue another request to `GetDedicatedIps`, passing this token in the `NextToken` parameter.  
Type: String

## Errors
<a name="API_GetDedicatedIps_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetDedicatedIps_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetDedicatedIps) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetDedicatedIps) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetDedicatedIps) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetDedicatedIps) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetDedicatedIps) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetDedicatedIps) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetDedicatedIps) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetDedicatedIps) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetDedicatedIps) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetDedicatedIps) 

# GetDeliverabilityDashboardOptions
<a name="API_GetDeliverabilityDashboardOptions"></a>

Retrieve information about the status of the Deliverability dashboard for your account. When the Deliverability dashboard is enabled, you gain access to reputation, deliverability, and other metrics for the domains that you use to send email. You also gain the ability to perform predictive inbox placement tests.

When you use the Deliverability dashboard, you pay a monthly subscription charge, in addition to any other fees that you accrue by using Amazon SES and other AWS services. For more information about the features and cost of a Deliverability dashboard subscription, see [Amazon SES Pricing](http://aws.amazon.com/ses/pricing/).

## Request Syntax
<a name="API_GetDeliverabilityDashboardOptions_RequestSyntax"></a>

```
GET /v2/email/deliverability-dashboard HTTP/1.1
```

## URI Request Parameters
<a name="API_GetDeliverabilityDashboardOptions_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_GetDeliverabilityDashboardOptions_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetDeliverabilityDashboardOptions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountStatus": "string",
   "ActiveSubscribedDomains": [ 
      { 
         "Domain": "string",
         "InboxPlacementTrackingOption": { 
            "Global": boolean,
            "TrackedIsps": [ "string" ]
         },
         "SubscriptionStartDate": number
      }
   ],
   "DashboardEnabled": boolean,
   "PendingExpirationSubscribedDomains": [ 
      { 
         "Domain": "string",
         "InboxPlacementTrackingOption": { 
            "Global": boolean,
            "TrackedIsps": [ "string" ]
         },
         "SubscriptionStartDate": number
      }
   ],
   "SubscriptionExpiryDate": number
}
```

## Response Elements
<a name="API_GetDeliverabilityDashboardOptions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AccountStatus](#API_GetDeliverabilityDashboardOptions_ResponseSyntax) **   <a name="SES-GetDeliverabilityDashboardOptions-response-AccountStatus"></a>
The current status of your Deliverability dashboard subscription. If this value is `PENDING_EXPIRATION`, your subscription is scheduled to expire at the end of the current calendar month.  
Type: String  
Valid Values: `ACTIVE | PENDING_EXPIRATION | DISABLED` 

 ** [ActiveSubscribedDomains](#API_GetDeliverabilityDashboardOptions_ResponseSyntax) **   <a name="SES-GetDeliverabilityDashboardOptions-response-ActiveSubscribedDomains"></a>
An array of objects, one for each verified domain that you use to send email and currently has an active Deliverability dashboard subscription that isn’t scheduled to expire at the end of the current calendar month.  
Type: Array of [DomainDeliverabilityTrackingOption](API_DomainDeliverabilityTrackingOption.md) objects

 ** [DashboardEnabled](#API_GetDeliverabilityDashboardOptions_ResponseSyntax) **   <a name="SES-GetDeliverabilityDashboardOptions-response-DashboardEnabled"></a>
Specifies whether the Deliverability dashboard is enabled. If this value is `true`, the dashboard is enabled.  
Type: Boolean

 ** [PendingExpirationSubscribedDomains](#API_GetDeliverabilityDashboardOptions_ResponseSyntax) **   <a name="SES-GetDeliverabilityDashboardOptions-response-PendingExpirationSubscribedDomains"></a>
An array of objects, one for each verified domain that you use to send email and currently has an active Deliverability dashboard subscription that's scheduled to expire at the end of the current calendar month.  
Type: Array of [DomainDeliverabilityTrackingOption](API_DomainDeliverabilityTrackingOption.md) objects

 ** [SubscriptionExpiryDate](#API_GetDeliverabilityDashboardOptions_ResponseSyntax) **   <a name="SES-GetDeliverabilityDashboardOptions-response-SubscriptionExpiryDate"></a>
The date when your current subscription to the Deliverability dashboard is scheduled to expire, if your subscription is scheduled to expire at the end of the current calendar month. This value is null if you have an active subscription that isn’t due to expire at the end of the month.  
Type: Timestamp

## Errors
<a name="API_GetDeliverabilityDashboardOptions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetDeliverabilityDashboardOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetDeliverabilityDashboardOptions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetDeliverabilityDashboardOptions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetDeliverabilityDashboardOptions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetDeliverabilityDashboardOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetDeliverabilityDashboardOptions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetDeliverabilityDashboardOptions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetDeliverabilityDashboardOptions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetDeliverabilityDashboardOptions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetDeliverabilityDashboardOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetDeliverabilityDashboardOptions) 

# GetDeliverabilityTestReport
<a name="API_GetDeliverabilityTestReport"></a>

Retrieve the results of a predictive inbox placement test.

## Request Syntax
<a name="API_GetDeliverabilityTestReport_RequestSyntax"></a>

```
GET /v2/email/deliverability-dashboard/test-reports/ReportId HTTP/1.1
```

## URI Request Parameters
<a name="API_GetDeliverabilityTestReport_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ReportId](#API_GetDeliverabilityTestReport_RequestSyntax) **   <a name="SES-GetDeliverabilityTestReport-request-uri-ReportId"></a>
A unique string that identifies the predictive inbox placement test.  
Required: Yes

## Request Body
<a name="API_GetDeliverabilityTestReport_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetDeliverabilityTestReport_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DeliverabilityTestReport": { 
      "CreateDate": number,
      "DeliverabilityTestStatus": "string",
      "FromEmailAddress": "string",
      "ReportId": "string",
      "ReportName": "string",
      "Subject": "string"
   },
   "IspPlacements": [ 
      { 
         "IspName": "string",
         "PlacementStatistics": { 
            "DkimPercentage": number,
            "InboxPercentage": number,
            "MissingPercentage": number,
            "SpamPercentage": number,
            "SpfPercentage": number
         }
      }
   ],
   "Message": "string",
   "OverallPlacement": { 
      "DkimPercentage": number,
      "InboxPercentage": number,
      "MissingPercentage": number,
      "SpamPercentage": number,
      "SpfPercentage": number
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Response Elements
<a name="API_GetDeliverabilityTestReport_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DeliverabilityTestReport](#API_GetDeliverabilityTestReport_ResponseSyntax) **   <a name="SES-GetDeliverabilityTestReport-response-DeliverabilityTestReport"></a>
An object that contains the results of the predictive inbox placement test.  
Type: [DeliverabilityTestReport](API_DeliverabilityTestReport.md) object

 ** [IspPlacements](#API_GetDeliverabilityTestReport_ResponseSyntax) **   <a name="SES-GetDeliverabilityTestReport-response-IspPlacements"></a>
An object that describes how the test email was handled by several email providers, including Gmail, Hotmail, Yahoo, AOL, and others.  
Type: Array of [IspPlacement](API_IspPlacement.md) objects

 ** [Message](#API_GetDeliverabilityTestReport_ResponseSyntax) **   <a name="SES-GetDeliverabilityTestReport-response-Message"></a>
An object that contains the message that you sent when you performed this predictive inbox placement test.  
Type: String

 ** [OverallPlacement](#API_GetDeliverabilityTestReport_ResponseSyntax) **   <a name="SES-GetDeliverabilityTestReport-response-OverallPlacement"></a>
An object that specifies how many test messages that were sent during the predictive inbox placement test were delivered to recipients' inboxes, how many were sent to recipients' spam folders, and how many weren't delivered.  
Type: [PlacementStatistics](API_PlacementStatistics.md) object

 ** [Tags](#API_GetDeliverabilityTestReport_ResponseSyntax) **   <a name="SES-GetDeliverabilityTestReport-response-Tags"></a>
An array of objects that define the tags (keys and values) that are associated with the predictive inbox placement test.  
Type: Array of [Tag](API_Tag.md) objects

## Errors
<a name="API_GetDeliverabilityTestReport_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetDeliverabilityTestReport_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetDeliverabilityTestReport) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetDeliverabilityTestReport) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetDeliverabilityTestReport) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetDeliverabilityTestReport) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetDeliverabilityTestReport) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetDeliverabilityTestReport) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetDeliverabilityTestReport) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetDeliverabilityTestReport) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetDeliverabilityTestReport) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetDeliverabilityTestReport) 

# GetDomainDeliverabilityCampaign
<a name="API_GetDomainDeliverabilityCampaign"></a>

Retrieve all the deliverability data for a specific campaign. This data is available for a campaign only if the campaign sent email by using a domain that the Deliverability dashboard is enabled for.

## Request Syntax
<a name="API_GetDomainDeliverabilityCampaign_RequestSyntax"></a>

```
GET /v2/email/deliverability-dashboard/campaigns/CampaignId HTTP/1.1
```

## URI Request Parameters
<a name="API_GetDomainDeliverabilityCampaign_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CampaignId](#API_GetDomainDeliverabilityCampaign_RequestSyntax) **   <a name="SES-GetDomainDeliverabilityCampaign-request-uri-CampaignId"></a>
The unique identifier for the campaign. The Deliverability dashboard automatically generates and assigns this identifier to a campaign.  
Required: Yes

## Request Body
<a name="API_GetDomainDeliverabilityCampaign_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetDomainDeliverabilityCampaign_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DomainDeliverabilityCampaign": { 
      "CampaignId": "string",
      "DeleteRate": number,
      "Esps": [ "string" ],
      "FirstSeenDateTime": number,
      "FromAddress": "string",
      "ImageUrl": "string",
      "InboxCount": number,
      "LastSeenDateTime": number,
      "ProjectedVolume": number,
      "ReadDeleteRate": number,
      "ReadRate": number,
      "SendingIps": [ "string" ],
      "SpamCount": number,
      "Subject": "string"
   }
}
```

## Response Elements
<a name="API_GetDomainDeliverabilityCampaign_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DomainDeliverabilityCampaign](#API_GetDomainDeliverabilityCampaign_ResponseSyntax) **   <a name="SES-GetDomainDeliverabilityCampaign-response-DomainDeliverabilityCampaign"></a>
An object that contains the deliverability data for the campaign.  
Type: [DomainDeliverabilityCampaign](API_DomainDeliverabilityCampaign.md) object

## Errors
<a name="API_GetDomainDeliverabilityCampaign_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetDomainDeliverabilityCampaign_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetDomainDeliverabilityCampaign) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetDomainDeliverabilityCampaign) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetDomainDeliverabilityCampaign) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetDomainDeliverabilityCampaign) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetDomainDeliverabilityCampaign) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetDomainDeliverabilityCampaign) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetDomainDeliverabilityCampaign) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetDomainDeliverabilityCampaign) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetDomainDeliverabilityCampaign) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetDomainDeliverabilityCampaign) 

# GetDomainStatisticsReport
<a name="API_GetDomainStatisticsReport"></a>

Retrieve inbox placement and engagement rates for the domains that you use to send email.

## Request Syntax
<a name="API_GetDomainStatisticsReport_RequestSyntax"></a>

```
GET /v2/email/deliverability-dashboard/statistics-report/Domain?EndDate=EndDate&StartDate=StartDate HTTP/1.1
```

## URI Request Parameters
<a name="API_GetDomainStatisticsReport_RequestParameters"></a>

The request uses the following URI parameters.

 ** [Domain](#API_GetDomainStatisticsReport_RequestSyntax) **   <a name="SES-GetDomainStatisticsReport-request-uri-Domain"></a>
The domain that you want to obtain deliverability metrics for.  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [EndDate](#API_GetDomainStatisticsReport_RequestSyntax) **   <a name="SES-GetDomainStatisticsReport-request-uri-EndDate"></a>
The last day (in Unix time) that you want to obtain domain deliverability metrics for. The `EndDate` that you specify has to be less than or equal to 30 days after the `StartDate`.  
Required: Yes

 ** [StartDate](#API_GetDomainStatisticsReport_RequestSyntax) **   <a name="SES-GetDomainStatisticsReport-request-uri-StartDate"></a>
The first day (in Unix time) that you want to obtain domain deliverability metrics for.  
Required: Yes

## Request Body
<a name="API_GetDomainStatisticsReport_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetDomainStatisticsReport_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DailyVolumes": [ 
      { 
         "DomainIspPlacements": [ 
            { 
               "InboxPercentage": number,
               "InboxRawCount": number,
               "IspName": "string",
               "SpamPercentage": number,
               "SpamRawCount": number
            }
         ],
         "StartDate": number,
         "VolumeStatistics": { 
            "InboxRawCount": number,
            "ProjectedInbox": number,
            "ProjectedSpam": number,
            "SpamRawCount": number
         }
      }
   ],
   "OverallVolume": { 
      "DomainIspPlacements": [ 
         { 
            "InboxPercentage": number,
            "InboxRawCount": number,
            "IspName": "string",
            "SpamPercentage": number,
            "SpamRawCount": number
         }
      ],
      "ReadRatePercent": number,
      "VolumeStatistics": { 
         "InboxRawCount": number,
         "ProjectedInbox": number,
         "ProjectedSpam": number,
         "SpamRawCount": number
      }
   }
}
```

## Response Elements
<a name="API_GetDomainStatisticsReport_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DailyVolumes](#API_GetDomainStatisticsReport_ResponseSyntax) **   <a name="SES-GetDomainStatisticsReport-response-DailyVolumes"></a>
An object that contains deliverability metrics for the domain that you specified. This object contains data for each day, starting on the `StartDate` and ending on the `EndDate`.  
Type: Array of [DailyVolume](API_DailyVolume.md) objects

 ** [OverallVolume](#API_GetDomainStatisticsReport_ResponseSyntax) **   <a name="SES-GetDomainStatisticsReport-response-OverallVolume"></a>
An object that contains deliverability metrics for the domain that you specified. The data in this object is a summary of all of the data that was collected from the `StartDate` to the `EndDate`.  
Type: [OverallVolume](API_OverallVolume.md) object

## Errors
<a name="API_GetDomainStatisticsReport_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetDomainStatisticsReport_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetDomainStatisticsReport) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetDomainStatisticsReport) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetDomainStatisticsReport) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetDomainStatisticsReport) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetDomainStatisticsReport) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetDomainStatisticsReport) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetDomainStatisticsReport) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetDomainStatisticsReport) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetDomainStatisticsReport) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetDomainStatisticsReport) 

# GetEmailAddressInsights
<a name="API_GetEmailAddressInsights"></a>

Provides validation insights about a specific email address, including syntax validation, DNS record checks, mailbox existence, and other deliverability factors.

## Request Syntax
<a name="API_GetEmailAddressInsights_RequestSyntax"></a>

```
POST /v2/email/email-address-insights/ HTTP/1.1
Content-type: application/json

{
   "EmailAddress": "string"
}
```

## URI Request Parameters
<a name="API_GetEmailAddressInsights_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_GetEmailAddressInsights_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [EmailAddress](#API_GetEmailAddressInsights_RequestSyntax) **   <a name="SES-GetEmailAddressInsights-request-EmailAddress"></a>
The email address to analyze for validation insights.  
Type: String  
Required: Yes

## Response Syntax
<a name="API_GetEmailAddressInsights_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "MailboxValidation": { 
      "Evaluations": { 
         "HasValidDnsRecords": { 
            "ConfidenceVerdict": "string"
         },
         "HasValidSyntax": { 
            "ConfidenceVerdict": "string"
         },
         "IsDisposable": { 
            "ConfidenceVerdict": "string"
         },
         "IsRandomInput": { 
            "ConfidenceVerdict": "string"
         },
         "IsRoleAddress": { 
            "ConfidenceVerdict": "string"
         },
         "MailboxExists": { 
            "ConfidenceVerdict": "string"
         }
      },
      "IsValid": { 
         "ConfidenceVerdict": "string"
      }
   }
}
```

## Response Elements
<a name="API_GetEmailAddressInsights_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [MailboxValidation](#API_GetEmailAddressInsights_ResponseSyntax) **   <a name="SES-GetEmailAddressInsights-response-MailboxValidation"></a>
Detailed validation results for the email address.  
Type: [MailboxValidation](API_MailboxValidation.md) object

## Errors
<a name="API_GetEmailAddressInsights_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetEmailAddressInsights_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetEmailAddressInsights) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetEmailAddressInsights) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetEmailAddressInsights) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetEmailAddressInsights) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetEmailAddressInsights) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetEmailAddressInsights) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetEmailAddressInsights) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetEmailAddressInsights) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetEmailAddressInsights) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetEmailAddressInsights) 

# GetEmailIdentity
<a name="API_GetEmailIdentity"></a>

Provides information about a specific identity, including the identity's verification status, sending authorization policies, its DKIM authentication status, and its custom Mail-From settings.

## Request Syntax
<a name="API_GetEmailIdentity_RequestSyntax"></a>

```
GET /v2/email/identities/EmailIdentity HTTP/1.1
```

## URI Request Parameters
<a name="API_GetEmailIdentity_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailIdentity](#API_GetEmailIdentity_RequestSyntax) **   <a name="SES-GetEmailIdentity-request-uri-EmailIdentity"></a>
The email identity.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_GetEmailIdentity_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetEmailIdentity_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ConfigurationSetName": "string",
   "DkimAttributes": { 
      "CurrentSigningKeyLength": "string",
      "LastKeyGenerationTimestamp": number,
      "NextSigningKeyLength": "string",
      "SigningAttributesOrigin": "string",
      "SigningEnabled": boolean,
      "SigningHostedZone": "string",
      "Status": "string",
      "Tokens": [ "string" ]
   },
   "FeedbackForwardingStatus": boolean,
   "IdentityType": "string",
   "MailFromAttributes": { 
      "BehaviorOnMxFailure": "string",
      "MailFromDomain": "string",
      "MailFromDomainStatus": "string"
   },
   "Policies": { 
      "string" : "string" 
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "VerificationInfo": { 
      "ErrorType": "string",
      "LastCheckedTimestamp": number,
      "LastSuccessTimestamp": number,
      "SOARecord": { 
         "AdminEmail": "string",
         "PrimaryNameServer": "string",
         "SerialNumber": number
      }
   },
   "VerificationStatus": "string",
   "VerifiedForSendingStatus": boolean
}
```

## Response Elements
<a name="API_GetEmailIdentity_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ConfigurationSetName](#API_GetEmailIdentity_ResponseSyntax) **   <a name="SES-GetEmailIdentity-response-ConfigurationSetName"></a>
The configuration set used by default when sending from this identity.  
Type: String

 ** [DkimAttributes](#API_GetEmailIdentity_ResponseSyntax) **   <a name="SES-GetEmailIdentity-response-DkimAttributes"></a>
An object that contains information about the DKIM attributes for the identity.  
Type: [DkimAttributes](API_DkimAttributes.md) object

 ** [FeedbackForwardingStatus](#API_GetEmailIdentity_ResponseSyntax) **   <a name="SES-GetEmailIdentity-response-FeedbackForwardingStatus"></a>
The feedback forwarding configuration for the identity.  
If the value is `true`, you receive email notifications when bounce or complaint events occur. These notifications are sent to the address that you specified in the `Return-Path` header of the original email.  
You're required to have a method of tracking bounces and complaints. If you haven't set up another mechanism for receiving bounce or complaint notifications (for example, by setting up an event destination), you receive an email notification when these events occur (even if this setting is disabled).  
Type: Boolean

 ** [IdentityType](#API_GetEmailIdentity_ResponseSyntax) **   <a name="SES-GetEmailIdentity-response-IdentityType"></a>
The email identity type. Note: the `MANAGED_DOMAIN` identity type is not supported.  
Type: String  
Valid Values: `EMAIL_ADDRESS | DOMAIN | MANAGED_DOMAIN` 

 ** [MailFromAttributes](#API_GetEmailIdentity_ResponseSyntax) **   <a name="SES-GetEmailIdentity-response-MailFromAttributes"></a>
An object that contains information about the Mail-From attributes for the email identity.  
Type: [MailFromAttributes](API_MailFromAttributes.md) object

 ** [Policies](#API_GetEmailIdentity_ResponseSyntax) **   <a name="SES-GetEmailIdentity-response-Policies"></a>
A map of policy names to policies.  
Type: String to string map  
Key Length Constraints: Minimum length of 1. Maximum length of 64.  
Value Length Constraints: Minimum length of 1.

 ** [Tags](#API_GetEmailIdentity_ResponseSyntax) **   <a name="SES-GetEmailIdentity-response-Tags"></a>
An array of objects that define the tags (keys and values) that are associated with the email identity.  
Type: Array of [Tag](API_Tag.md) objects

 ** [VerificationInfo](#API_GetEmailIdentity_ResponseSyntax) **   <a name="SES-GetEmailIdentity-response-VerificationInfo"></a>
An object that contains additional information about the verification status for the identity.  
Type: [VerificationInfo](API_VerificationInfo.md) object

 ** [VerificationStatus](#API_GetEmailIdentity_ResponseSyntax) **   <a name="SES-GetEmailIdentity-response-VerificationStatus"></a>
The verification status of the identity. The status can be one of the following:  
+  `PENDING` – The verification process was initiated, but Amazon SES hasn't yet been able to verify the identity.
+  `SUCCESS` – The verification process completed successfully.
+  `FAILED` – The verification process failed.
+  `TEMPORARY_FAILURE` – A temporary issue is preventing Amazon SES from determining the verification status of the identity.
+  `NOT_STARTED` – The verification process hasn't been initiated for the identity.
Type: String  
Valid Values: `PENDING | SUCCESS | FAILED | TEMPORARY_FAILURE | NOT_STARTED` 

 ** [VerifiedForSendingStatus](#API_GetEmailIdentity_ResponseSyntax) **   <a name="SES-GetEmailIdentity-response-VerifiedForSendingStatus"></a>
Specifies whether or not the identity is verified. You can only send email from verified email addresses or domains. For more information about verifying identities, see the [Amazon Pinpoint User Guide](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html).  
Type: Boolean

## Errors
<a name="API_GetEmailIdentity_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetEmailIdentity_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetEmailIdentity) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetEmailIdentity) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetEmailIdentity) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetEmailIdentity) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetEmailIdentity) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetEmailIdentity) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetEmailIdentity) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetEmailIdentity) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetEmailIdentity) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetEmailIdentity) 

# GetEmailIdentityPolicies
<a name="API_GetEmailIdentityPolicies"></a>

Returns the requested sending authorization policies for the given identity (an email address or a domain). The policies are returned as a map of policy names to policy contents. You can retrieve a maximum of 20 policies at a time.

**Note**  
This API is for the identity owner only. If you have not verified the identity, this API will return an error.

Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html).

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_GetEmailIdentityPolicies_RequestSyntax"></a>

```
GET /v2/email/identities/EmailIdentity/policies HTTP/1.1
```

## URI Request Parameters
<a name="API_GetEmailIdentityPolicies_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailIdentity](#API_GetEmailIdentityPolicies_RequestSyntax) **   <a name="SES-GetEmailIdentityPolicies-request-uri-EmailIdentity"></a>
The email identity.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_GetEmailIdentityPolicies_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetEmailIdentityPolicies_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Policies": { 
      "string" : "string" 
   }
}
```

## Response Elements
<a name="API_GetEmailIdentityPolicies_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Policies](#API_GetEmailIdentityPolicies_ResponseSyntax) **   <a name="SES-GetEmailIdentityPolicies-response-Policies"></a>
A map of policy names to policies.  
Type: String to string map  
Key Length Constraints: Minimum length of 1. Maximum length of 64.  
Value Length Constraints: Minimum length of 1.

## Errors
<a name="API_GetEmailIdentityPolicies_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetEmailIdentityPolicies_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetEmailIdentityPolicies) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetEmailIdentityPolicies) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetEmailIdentityPolicies) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetEmailIdentityPolicies) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetEmailIdentityPolicies) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetEmailIdentityPolicies) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetEmailIdentityPolicies) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetEmailIdentityPolicies) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetEmailIdentityPolicies) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetEmailIdentityPolicies) 

# GetEmailTemplate
<a name="API_GetEmailTemplate"></a>

Displays the template object (which includes the subject line, HTML part and text part) for the template you specify.

You can execute this operation no more than 50 times per second.

## Request Syntax
<a name="API_GetEmailTemplate_RequestSyntax"></a>

```
GET /v2/email/templates/TemplateName HTTP/1.1
```

## URI Request Parameters
<a name="API_GetEmailTemplate_RequestParameters"></a>

The request uses the following URI parameters.

 ** [TemplateName](#API_GetEmailTemplate_RequestSyntax) **   <a name="SES-GetEmailTemplate-request-uri-TemplateName"></a>
The name of the template.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_GetEmailTemplate_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetEmailTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TemplateContent": { 
      "Html": "string",
      "Subject": "string",
      "Text": "string"
   },
   "TemplateName": "string"
}
```

## Response Elements
<a name="API_GetEmailTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Tags](#API_GetEmailTemplate_ResponseSyntax) **   <a name="SES-GetEmailTemplate-response-Tags"></a>
An array of objects that define the tags (keys and values) that are associated with the email template.  
Type: Array of [Tag](API_Tag.md) objects

 ** [TemplateContent](#API_GetEmailTemplate_ResponseSyntax) **   <a name="SES-GetEmailTemplate-response-TemplateContent"></a>
The content of the email template, composed of a subject line, an HTML part, and a text-only part.  
Type: [EmailTemplateContent](API_EmailTemplateContent.md) object

 ** [TemplateName](#API_GetEmailTemplate_ResponseSyntax) **   <a name="SES-GetEmailTemplate-response-TemplateName"></a>
The name of the template.  
Type: String  
Length Constraints: Minimum length of 1.

## Errors
<a name="API_GetEmailTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetEmailTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetEmailTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetEmailTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetEmailTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetEmailTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetEmailTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetEmailTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetEmailTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetEmailTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetEmailTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetEmailTemplate) 

# GetExportJob
<a name="API_GetExportJob"></a>

Provides information about an export job.

## Request Syntax
<a name="API_GetExportJob_RequestSyntax"></a>

```
GET /v2/email/export-jobs/JobId HTTP/1.1
```

## URI Request Parameters
<a name="API_GetExportJob_RequestParameters"></a>

The request uses the following URI parameters.

 ** [JobId](#API_GetExportJob_RequestSyntax) **   <a name="SES-GetExportJob-request-uri-JobId"></a>
The export job ID.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_GetExportJob_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetExportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CompletedTimestamp": number,
   "CreatedTimestamp": number,
   "ExportDataSource": { 
      "MessageInsightsDataSource": { 
         "EndDate": number,
         "Exclude": { 
            "Destination": [ "string" ],
            "FromEmailAddress": [ "string" ],
            "Isp": [ "string" ],
            "LastDeliveryEvent": [ "string" ],
            "LastEngagementEvent": [ "string" ],
            "Subject": [ "string" ]
         },
         "Include": { 
            "Destination": [ "string" ],
            "FromEmailAddress": [ "string" ],
            "Isp": [ "string" ],
            "LastDeliveryEvent": [ "string" ],
            "LastEngagementEvent": [ "string" ],
            "Subject": [ "string" ]
         },
         "MaxResults": number,
         "StartDate": number
      },
      "MetricsDataSource": { 
         "Dimensions": { 
            "string" : [ "string" ]
         },
         "EndDate": number,
         "Metrics": [ 
            { 
               "Aggregation": "string",
               "Name": "string"
            }
         ],
         "Namespace": "string",
         "StartDate": number
      }
   },
   "ExportDestination": { 
      "DataFormat": "string",
      "S3Url": "string"
   },
   "ExportSourceType": "string",
   "FailureInfo": { 
      "ErrorMessage": "string",
      "FailedRecordsS3Url": "string"
   },
   "JobId": "string",
   "JobStatus": "string",
   "Statistics": { 
      "ExportedRecordsCount": number,
      "ProcessedRecordsCount": number
   }
}
```

## Response Elements
<a name="API_GetExportJob_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CompletedTimestamp](#API_GetExportJob_ResponseSyntax) **   <a name="SES-GetExportJob-response-CompletedTimestamp"></a>
The timestamp of when the export job was completed.  
Type: Timestamp

 ** [CreatedTimestamp](#API_GetExportJob_ResponseSyntax) **   <a name="SES-GetExportJob-response-CreatedTimestamp"></a>
The timestamp of when the export job was created.  
Type: Timestamp

 ** [ExportDataSource](#API_GetExportJob_ResponseSyntax) **   <a name="SES-GetExportJob-response-ExportDataSource"></a>
The data source of the export job.  
Type: [ExportDataSource](API_ExportDataSource.md) object

 ** [ExportDestination](#API_GetExportJob_ResponseSyntax) **   <a name="SES-GetExportJob-response-ExportDestination"></a>
The destination of the export job.  
Type: [ExportDestination](API_ExportDestination.md) object

 ** [ExportSourceType](#API_GetExportJob_ResponseSyntax) **   <a name="SES-GetExportJob-response-ExportSourceType"></a>
The type of source of the export job.  
Type: String  
Valid Values: `METRICS_DATA | MESSAGE_INSIGHTS` 

 ** [FailureInfo](#API_GetExportJob_ResponseSyntax) **   <a name="SES-GetExportJob-response-FailureInfo"></a>
The failure details about an export job.  
Type: [FailureInfo](API_FailureInfo.md) object

 ** [JobId](#API_GetExportJob_ResponseSyntax) **   <a name="SES-GetExportJob-response-JobId"></a>
The export job ID.  
Type: String  
Length Constraints: Minimum length of 1.

 ** [JobStatus](#API_GetExportJob_ResponseSyntax) **   <a name="SES-GetExportJob-response-JobStatus"></a>
The status of the export job.  
Type: String  
Valid Values: `CREATED | PROCESSING | COMPLETED | FAILED | CANCELLED` 

 ** [Statistics](#API_GetExportJob_ResponseSyntax) **   <a name="SES-GetExportJob-response-Statistics"></a>
The statistics about the export job.  
Type: [ExportStatistics](API_ExportStatistics.md) object

## Errors
<a name="API_GetExportJob_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetExportJob_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetExportJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetExportJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetExportJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetExportJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetExportJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetExportJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetExportJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetExportJob) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetExportJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetExportJob) 

# GetImportJob
<a name="API_GetImportJob"></a>

Provides information about an import job.

## Request Syntax
<a name="API_GetImportJob_RequestSyntax"></a>

```
GET /v2/email/import-jobs/JobId HTTP/1.1
```

## URI Request Parameters
<a name="API_GetImportJob_RequestParameters"></a>

The request uses the following URI parameters.

 ** [JobId](#API_GetImportJob_RequestSyntax) **   <a name="SES-GetImportJob-request-uri-JobId"></a>
The ID of the import job.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_GetImportJob_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetImportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CompletedTimestamp": number,
   "CreatedTimestamp": number,
   "FailedRecordsCount": number,
   "FailureInfo": { 
      "ErrorMessage": "string",
      "FailedRecordsS3Url": "string"
   },
   "ImportDataSource": { 
      "DataFormat": "string",
      "S3Url": "string"
   },
   "ImportDestination": { 
      "ContactListDestination": { 
         "ContactListImportAction": "string",
         "ContactListName": "string"
      },
      "SuppressionListDestination": { 
         "SuppressionListImportAction": "string"
      }
   },
   "JobId": "string",
   "JobStatus": "string",
   "ProcessedRecordsCount": number
}
```

## Response Elements
<a name="API_GetImportJob_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CompletedTimestamp](#API_GetImportJob_ResponseSyntax) **   <a name="SES-GetImportJob-response-CompletedTimestamp"></a>
The time stamp of when the import job was completed.  
Type: Timestamp

 ** [CreatedTimestamp](#API_GetImportJob_ResponseSyntax) **   <a name="SES-GetImportJob-response-CreatedTimestamp"></a>
The time stamp of when the import job was created.  
Type: Timestamp

 ** [FailedRecordsCount](#API_GetImportJob_ResponseSyntax) **   <a name="SES-GetImportJob-response-FailedRecordsCount"></a>
The number of records that failed processing because of invalid input or other reasons.  
Type: Integer

 ** [FailureInfo](#API_GetImportJob_ResponseSyntax) **   <a name="SES-GetImportJob-response-FailureInfo"></a>
The failure details about an import job.  
Type: [FailureInfo](API_FailureInfo.md) object

 ** [ImportDataSource](#API_GetImportJob_ResponseSyntax) **   <a name="SES-GetImportJob-response-ImportDataSource"></a>
The data source of the import job.  
Type: [ImportDataSource](API_ImportDataSource.md) object

 ** [ImportDestination](#API_GetImportJob_ResponseSyntax) **   <a name="SES-GetImportJob-response-ImportDestination"></a>
The destination of the import job.  
Type: [ImportDestination](API_ImportDestination.md) object

 ** [JobId](#API_GetImportJob_ResponseSyntax) **   <a name="SES-GetImportJob-response-JobId"></a>
A string that represents the import job ID.  
Type: String  
Length Constraints: Minimum length of 1.

 ** [JobStatus](#API_GetImportJob_ResponseSyntax) **   <a name="SES-GetImportJob-response-JobStatus"></a>
The status of the import job.  
Type: String  
Valid Values: `CREATED | PROCESSING | COMPLETED | FAILED | CANCELLED` 

 ** [ProcessedRecordsCount](#API_GetImportJob_ResponseSyntax) **   <a name="SES-GetImportJob-response-ProcessedRecordsCount"></a>
The current number of records processed.  
Type: Integer

## Errors
<a name="API_GetImportJob_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetImportJob_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetImportJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetImportJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetImportJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetImportJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetImportJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetImportJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetImportJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetImportJob) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetImportJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetImportJob) 

# GetMessageInsights
<a name="API_GetMessageInsights"></a>

Provides information about a specific message, including the from address, the subject, the recipient address, email tags, as well as events associated with the message.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_GetMessageInsights_RequestSyntax"></a>

```
GET /v2/email/insights/MessageId/ HTTP/1.1
```

## URI Request Parameters
<a name="API_GetMessageInsights_RequestParameters"></a>

The request uses the following URI parameters.

 ** [MessageId](#API_GetMessageInsights_RequestSyntax) **   <a name="SES-GetMessageInsights-request-uri-MessageId"></a>
 A `MessageId` is a unique identifier for a message, and is returned when sending emails through Amazon SES.   
Required: Yes

## Request Body
<a name="API_GetMessageInsights_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetMessageInsights_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "EmailTags": [ 
      { 
         "Name": "string",
         "Value": "string"
      }
   ],
   "FromEmailAddress": "string",
   "Insights": [ 
      { 
         "Destination": "string",
         "Events": [ 
            { 
               "Details": { 
                  "Bounce": { 
                     "BounceSubType": "string",
                     "BounceType": "string",
                     "DiagnosticCode": "string"
                  },
                  "Complaint": { 
                     "ComplaintFeedbackType": "string",
                     "ComplaintSubType": "string"
                  }
               },
               "Timestamp": number,
               "Type": "string"
            }
         ],
         "Isp": "string"
      }
   ],
   "MessageId": "string",
   "Subject": "string"
}
```

## Response Elements
<a name="API_GetMessageInsights_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [EmailTags](#API_GetMessageInsights_ResponseSyntax) **   <a name="SES-GetMessageInsights-response-EmailTags"></a>
 A list of tags, in the form of name/value pairs, that were applied to the email you sent, along with Amazon SES [Auto-Tags](https://docs.aws.amazon.com/ses/latest/dg/monitor-using-event-publishing.html).   
Type: Array of [MessageTag](API_MessageTag.md) objects

 ** [FromEmailAddress](#API_GetMessageInsights_ResponseSyntax) **   <a name="SES-GetMessageInsights-response-FromEmailAddress"></a>
The from address used to send the message.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 320.

 ** [Insights](#API_GetMessageInsights_ResponseSyntax) **   <a name="SES-GetMessageInsights-response-Insights"></a>
A set of insights associated with the message.  
Type: Array of [EmailInsights](API_EmailInsights.md) objects

 ** [MessageId](#API_GetMessageInsights_ResponseSyntax) **   <a name="SES-GetMessageInsights-response-MessageId"></a>
A unique identifier for the message.  
Type: String

 ** [Subject](#API_GetMessageInsights_ResponseSyntax) **   <a name="SES-GetMessageInsights-response-Subject"></a>
The subject line of the message.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 998.

## Errors
<a name="API_GetMessageInsights_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetMessageInsights_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetMessageInsights) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetMessageInsights) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetMessageInsights) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetMessageInsights) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetMessageInsights) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetMessageInsights) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetMessageInsights) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetMessageInsights) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetMessageInsights) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetMessageInsights) 

# GetMultiRegionEndpoint
<a name="API_GetMultiRegionEndpoint"></a>

Displays the multi-region endpoint (global-endpoint) configuration.

Only multi-region endpoints (global-endpoints) whose primary region is the AWS-Region where operation is executed can be displayed.

## Request Syntax
<a name="API_GetMultiRegionEndpoint_RequestSyntax"></a>

```
GET /v2/email/multi-region-endpoints/EndpointName HTTP/1.1
```

## URI Request Parameters
<a name="API_GetMultiRegionEndpoint_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EndpointName](#API_GetMultiRegionEndpoint_RequestSyntax) **   <a name="SES-GetMultiRegionEndpoint-request-uri-EndpointName"></a>
The name of the multi-region endpoint (global-endpoint).  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `^[\w\-_]+$`   
Required: Yes

## Request Body
<a name="API_GetMultiRegionEndpoint_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetMultiRegionEndpoint_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreatedTimestamp": number,
   "EndpointId": "string",
   "EndpointName": "string",
   "LastUpdatedTimestamp": number,
   "Routes": [ 
      { 
         "Region": "string"
      }
   ],
   "Status": "string"
}
```

## Response Elements
<a name="API_GetMultiRegionEndpoint_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CreatedTimestamp](#API_GetMultiRegionEndpoint_ResponseSyntax) **   <a name="SES-GetMultiRegionEndpoint-response-CreatedTimestamp"></a>
The time stamp of when the multi-region endpoint (global-endpoint) was created.  
Type: Timestamp

 ** [EndpointId](#API_GetMultiRegionEndpoint_ResponseSyntax) **   <a name="SES-GetMultiRegionEndpoint-response-EndpointId"></a>
The ID of the multi-region endpoint (global-endpoint).  
Type: String

 ** [EndpointName](#API_GetMultiRegionEndpoint_ResponseSyntax) **   <a name="SES-GetMultiRegionEndpoint-response-EndpointName"></a>
The name of the multi-region endpoint (global-endpoint).  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `^[\w\-_]+$` 

 ** [LastUpdatedTimestamp](#API_GetMultiRegionEndpoint_ResponseSyntax) **   <a name="SES-GetMultiRegionEndpoint-response-LastUpdatedTimestamp"></a>
The time stamp of when the multi-region endpoint (global-endpoint) was last updated.  
Type: Timestamp

 ** [Routes](#API_GetMultiRegionEndpoint_ResponseSyntax) **   <a name="SES-GetMultiRegionEndpoint-response-Routes"></a>
Contains routes information for the multi-region endpoint (global-endpoint).  
Type: Array of [Route](API_Route.md) objects

 ** [Status](#API_GetMultiRegionEndpoint_ResponseSyntax) **   <a name="SES-GetMultiRegionEndpoint-response-Status"></a>
The status of the multi-region endpoint (global-endpoint).  
+  `CREATING` – The resource is being provisioned.
+  `READY` – The resource is ready to use.
+  `FAILED` – The resource failed to be provisioned.
+  `DELETING` – The resource is being deleted as requested.
Type: String  
Valid Values: `CREATING | READY | FAILED | DELETING` 

## Errors
<a name="API_GetMultiRegionEndpoint_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetMultiRegionEndpoint_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetMultiRegionEndpoint) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetMultiRegionEndpoint) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetMultiRegionEndpoint) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetMultiRegionEndpoint) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetMultiRegionEndpoint) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetMultiRegionEndpoint) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetMultiRegionEndpoint) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetMultiRegionEndpoint) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetMultiRegionEndpoint) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetMultiRegionEndpoint) 

# GetReputationEntity
<a name="API_GetReputationEntity"></a>

Retrieve information about a specific reputation entity, including its reputation management policy, customer-managed status, AWS Amazon SES-managed status, and aggregate sending status.

 *Reputation entities* represent resources in your Amazon SES account that have reputation tracking and management capabilities. The reputation impact reflects the highest impact reputation finding for the entity. Reputation findings can be retrieved using the `ListRecommendations` operation.

## Request Syntax
<a name="API_GetReputationEntity_RequestSyntax"></a>

```
GET /v2/email/reputation/entities/ReputationEntityType/ReputationEntityReference HTTP/1.1
```

## URI Request Parameters
<a name="API_GetReputationEntity_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ReputationEntityReference](#API_GetReputationEntity_RequestSyntax) **   <a name="SES-GetReputationEntity-request-uri-ReputationEntityReference"></a>
The unique identifier for the reputation entity. For resource-type entities, this is the Amazon Resource Name (ARN) of the resource.  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [ReputationEntityType](#API_GetReputationEntity_RequestSyntax) **   <a name="SES-GetReputationEntity-request-uri-ReputationEntityType"></a>
The type of reputation entity. Currently, only `RESOURCE` type entities are supported.  
Valid Values: `RESOURCE`   
Required: Yes

## Request Body
<a name="API_GetReputationEntity_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetReputationEntity_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ReputationEntity": { 
      "AwsSesManagedStatus": { 
         "Cause": "string",
         "LastUpdatedTimestamp": number,
         "Status": "string"
      },
      "CustomerManagedStatus": { 
         "Cause": "string",
         "LastUpdatedTimestamp": number,
         "Status": "string"
      },
      "ReputationEntityReference": "string",
      "ReputationEntityType": "string",
      "ReputationImpact": "string",
      "ReputationManagementPolicy": "string",
      "SendingStatusAggregate": "string"
   }
}
```

## Response Elements
<a name="API_GetReputationEntity_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ReputationEntity](#API_GetReputationEntity_ResponseSyntax) **   <a name="SES-GetReputationEntity-response-ReputationEntity"></a>
The reputation entity information, including status records, policy configuration, and reputation impact.  
Type: [ReputationEntity](API_ReputationEntity.md) object

## Errors
<a name="API_GetReputationEntity_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetReputationEntity_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetReputationEntity) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetReputationEntity) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetReputationEntity) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetReputationEntity) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetReputationEntity) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetReputationEntity) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetReputationEntity) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetReputationEntity) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetReputationEntity) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetReputationEntity) 

# GetSuppressedDestination
<a name="API_GetSuppressedDestination"></a>

Retrieves information about a specific email address that's on the suppression list for your account.

## Request Syntax
<a name="API_GetSuppressedDestination_RequestSyntax"></a>

```
GET /v2/email/suppression/addresses/EmailAddress HTTP/1.1
```

## URI Request Parameters
<a name="API_GetSuppressedDestination_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailAddress](#API_GetSuppressedDestination_RequestSyntax) **   <a name="SES-GetSuppressedDestination-request-uri-EmailAddress"></a>
The email address that's on the account suppression list.  
Required: Yes

## Request Body
<a name="API_GetSuppressedDestination_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetSuppressedDestination_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "SuppressedDestination": { 
      "Attributes": { 
         "FeedbackId": "string",
         "MessageId": "string"
      },
      "EmailAddress": "string",
      "LastUpdateTime": number,
      "Reason": "string"
   }
}
```

## Response Elements
<a name="API_GetSuppressedDestination_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [SuppressedDestination](#API_GetSuppressedDestination_ResponseSyntax) **   <a name="SES-GetSuppressedDestination-response-SuppressedDestination"></a>
An object containing information about the suppressed email address.  
Type: [SuppressedDestination](API_SuppressedDestination.md) object

## Errors
<a name="API_GetSuppressedDestination_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetSuppressedDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetSuppressedDestination) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetSuppressedDestination) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetSuppressedDestination) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetSuppressedDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetSuppressedDestination) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetSuppressedDestination) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetSuppressedDestination) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetSuppressedDestination) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetSuppressedDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetSuppressedDestination) 

# GetTenant
<a name="API_GetTenant"></a>

Get information about a specific tenant, including the tenant's name, ID, ARN, creation timestamp, tags, and sending status.

## Request Syntax
<a name="API_GetTenant_RequestSyntax"></a>

```
POST /v2/email/tenants/get HTTP/1.1
Content-type: application/json

{
   "TenantName": "string"
}
```

## URI Request Parameters
<a name="API_GetTenant_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_GetTenant_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [TenantName](#API_GetTenant_RequestSyntax) **   <a name="SES-GetTenant-request-TenantName"></a>
The name of the tenant to retrieve information about.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_GetTenant_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Tenant": { 
      "CreatedTimestamp": number,
      "SendingStatus": "string",
      "Tags": [ 
         { 
            "Key": "string",
            "Value": "string"
         }
      ],
      "TenantArn": "string",
      "TenantId": "string",
      "TenantName": "string"
   }
}
```

## Response Elements
<a name="API_GetTenant_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Tenant](#API_GetTenant_ResponseSyntax) **   <a name="SES-GetTenant-response-Tenant"></a>
A structure that contains details about the tenant.  
Type: [Tenant](API_Tenant.md) object

## Errors
<a name="API_GetTenant_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_GetTenant_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/GetTenant) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/GetTenant) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GetTenant) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/GetTenant) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GetTenant) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/GetTenant) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/GetTenant) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/GetTenant) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/GetTenant) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GetTenant) 

# ListConfigurationSets
<a name="API_ListConfigurationSets"></a>

List all of the configuration sets associated with your account in the current region.

 *Configuration sets* are groups of rules that you can apply to the emails you send. You apply a configuration set to an email by including a reference to the configuration set in the headers of the email. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.

## Request Syntax
<a name="API_ListConfigurationSets_RequestSyntax"></a>

```
GET /v2/email/configuration-sets?NextToken=NextToken&PageSize=PageSize HTTP/1.1
```

## URI Request Parameters
<a name="API_ListConfigurationSets_RequestParameters"></a>

The request uses the following URI parameters.

 ** [NextToken](#API_ListConfigurationSets_RequestSyntax) **   <a name="SES-ListConfigurationSets-request-uri-NextToken"></a>
A token returned from a previous call to `ListConfigurationSets` to indicate the position in the list of configuration sets.

 ** [PageSize](#API_ListConfigurationSets_RequestSyntax) **   <a name="SES-ListConfigurationSets-request-uri-PageSize"></a>
The number of results to show in a single call to `ListConfigurationSets`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.

## Request Body
<a name="API_ListConfigurationSets_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListConfigurationSets_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ConfigurationSets": [ "string" ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListConfigurationSets_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ConfigurationSets](#API_ListConfigurationSets_ResponseSyntax) **   <a name="SES-ListConfigurationSets-response-ConfigurationSets"></a>
An array that contains all of the configuration sets in your Amazon SES account in the current AWS Region.  
Type: Array of strings

 ** [NextToken](#API_ListConfigurationSets_ResponseSyntax) **   <a name="SES-ListConfigurationSets-response-NextToken"></a>
A token that indicates that there are additional configuration sets to list. To view additional configuration sets, issue another request to `ListConfigurationSets`, and pass this token in the `NextToken` parameter.  
Type: String

## Errors
<a name="API_ListConfigurationSets_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListConfigurationSets_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListConfigurationSets) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListConfigurationSets) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListConfigurationSets) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListConfigurationSets) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListConfigurationSets) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListConfigurationSets) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListConfigurationSets) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListConfigurationSets) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListConfigurationSets) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListConfigurationSets) 

# ListContactLists
<a name="API_ListContactLists"></a>

Lists all of the contact lists available.

If your output includes a "NextToken" field with a string value, this indicates there may be additional contacts on the filtered list - regardless of the number of contacts returned.

## Request Syntax
<a name="API_ListContactLists_RequestSyntax"></a>

```
GET /v2/email/contact-lists?NextToken=NextToken&PageSize=PageSize HTTP/1.1
```

## URI Request Parameters
<a name="API_ListContactLists_RequestParameters"></a>

The request uses the following URI parameters.

 ** [NextToken](#API_ListContactLists_RequestSyntax) **   <a name="SES-ListContactLists-request-uri-NextToken"></a>
A string token indicating that there might be additional contact lists available to be listed. Use the token provided in the Response to use in the subsequent call to ListContactLists with the same parameters to retrieve the next page of contact lists.

 ** [PageSize](#API_ListContactLists_RequestSyntax) **   <a name="SES-ListContactLists-request-uri-PageSize"></a>
Maximum number of contact lists to return at once. Use this parameter to paginate results. If additional contact lists exist beyond the specified limit, the `NextToken` element is sent in the response. Use the `NextToken` value in subsequent requests to retrieve additional lists.

## Request Body
<a name="API_ListContactLists_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListContactLists_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ContactLists": [ 
      { 
         "ContactListName": "string",
         "LastUpdatedTimestamp": number
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListContactLists_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ContactLists](#API_ListContactLists_ResponseSyntax) **   <a name="SES-ListContactLists-response-ContactLists"></a>
The available contact lists.  
Type: Array of [ContactList](API_ContactList.md) objects

 ** [NextToken](#API_ListContactLists_ResponseSyntax) **   <a name="SES-ListContactLists-response-NextToken"></a>
A string token indicating that there might be additional contact lists available to be listed. Copy this token to a subsequent call to `ListContactLists` with the same parameters to retrieve the next page of contact lists.  
Type: String

## Errors
<a name="API_ListContactLists_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListContactLists_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListContactLists) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListContactLists) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListContactLists) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListContactLists) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListContactLists) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListContactLists) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListContactLists) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListContactLists) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListContactLists) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListContactLists) 

# ListContacts
<a name="API_ListContacts"></a>

Lists the contacts present in a specific contact list.

## Request Syntax
<a name="API_ListContacts_RequestSyntax"></a>

```
POST /v2/email/contact-lists/ContactListName/contacts/list HTTP/1.1
Content-type: application/json

{
   "Filter": { 
      "FilteredStatus": "string",
      "TopicFilter": { 
         "TopicName": "string",
         "UseDefaultIfPreferenceUnavailable": boolean
      }
   },
   "NextToken": "string",
   "PageSize": number
}
```

## URI Request Parameters
<a name="API_ListContacts_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ContactListName](#API_ListContacts_RequestSyntax) **   <a name="SES-ListContacts-request-uri-ContactListName"></a>
The name of the contact list.  
Required: Yes

## Request Body
<a name="API_ListContacts_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Filter](#API_ListContacts_RequestSyntax) **   <a name="SES-ListContacts-request-Filter"></a>
A filter that can be applied to a list of contacts.  
Type: [ListContactsFilter](API_ListContactsFilter.md) object  
Required: No

 ** [NextToken](#API_ListContacts_RequestSyntax) **   <a name="SES-ListContacts-request-NextToken"></a>
A string token indicating that there might be additional contacts available to be listed. Use the token provided in the Response to use in the subsequent call to ListContacts with the same parameters to retrieve the next page of contacts.  
Type: String  
Required: No

 ** [PageSize](#API_ListContacts_RequestSyntax) **   <a name="SES-ListContacts-request-PageSize"></a>
The number of contacts that may be returned at once, which is dependent on if there are more or less contacts than the value of the PageSize. Use this parameter to paginate results. If additional contacts exist beyond the specified limit, the `NextToken` element is sent in the response. Use the `NextToken` value in subsequent requests to retrieve additional contacts.  
Type: Integer  
Required: No

## Response Syntax
<a name="API_ListContacts_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Contacts": [ 
      { 
         "EmailAddress": "string",
         "LastUpdatedTimestamp": number,
         "TopicDefaultPreferences": [ 
            { 
               "SubscriptionStatus": "string",
               "TopicName": "string"
            }
         ],
         "TopicPreferences": [ 
            { 
               "SubscriptionStatus": "string",
               "TopicName": "string"
            }
         ],
         "UnsubscribeAll": boolean
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListContacts_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Contacts](#API_ListContacts_ResponseSyntax) **   <a name="SES-ListContacts-response-Contacts"></a>
The contacts present in a specific contact list.  
Type: Array of [Contact](API_Contact.md) objects

 ** [NextToken](#API_ListContacts_ResponseSyntax) **   <a name="SES-ListContacts-response-NextToken"></a>
A string token indicating that there might be additional contacts available to be listed. Copy this token to a subsequent call to `ListContacts` with the same parameters to retrieve the next page of contacts.  
Type: String

## Errors
<a name="API_ListContacts_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListContacts_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListContacts) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListContacts) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListContacts) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListContacts) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListContacts) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListContacts) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListContacts) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListContacts) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListContacts) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListContacts) 

# ListCustomVerificationEmailTemplates
<a name="API_ListCustomVerificationEmailTemplates"></a>

Lists the existing custom verification email templates for your account in the current AWS Region.

For more information about custom verification email templates, see [Using custom verification email templates](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) in the *Amazon SES Developer Guide*.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_ListCustomVerificationEmailTemplates_RequestSyntax"></a>

```
GET /v2/email/custom-verification-email-templates?NextToken=NextToken&PageSize=PageSize HTTP/1.1
```

## URI Request Parameters
<a name="API_ListCustomVerificationEmailTemplates_RequestParameters"></a>

The request uses the following URI parameters.

 ** [NextToken](#API_ListCustomVerificationEmailTemplates_RequestSyntax) **   <a name="SES-ListCustomVerificationEmailTemplates-request-uri-NextToken"></a>
A token returned from a previous call to `ListCustomVerificationEmailTemplates` to indicate the position in the list of custom verification email templates.

 ** [PageSize](#API_ListCustomVerificationEmailTemplates_RequestSyntax) **   <a name="SES-ListCustomVerificationEmailTemplates-request-uri-PageSize"></a>
The number of results to show in a single call to `ListCustomVerificationEmailTemplates`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.  
The value you specify has to be at least 1, and can be no more than 50.

## Request Body
<a name="API_ListCustomVerificationEmailTemplates_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListCustomVerificationEmailTemplates_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CustomVerificationEmailTemplates": [ 
      { 
         "FailureRedirectionURL": "string",
         "FromEmailAddress": "string",
         "SuccessRedirectionURL": "string",
         "TemplateName": "string",
         "TemplateSubject": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListCustomVerificationEmailTemplates_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CustomVerificationEmailTemplates](#API_ListCustomVerificationEmailTemplates_ResponseSyntax) **   <a name="SES-ListCustomVerificationEmailTemplates-response-CustomVerificationEmailTemplates"></a>
A list of the custom verification email templates that exist in your account.  
Type: Array of [CustomVerificationEmailTemplateMetadata](API_CustomVerificationEmailTemplateMetadata.md) objects

 ** [NextToken](#API_ListCustomVerificationEmailTemplates_ResponseSyntax) **   <a name="SES-ListCustomVerificationEmailTemplates-response-NextToken"></a>
A token indicating that there are additional custom verification email templates available to be listed. Pass this token to a subsequent call to `ListCustomVerificationEmailTemplates` to retrieve the next 50 custom verification email templates.  
Type: String

## Errors
<a name="API_ListCustomVerificationEmailTemplates_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListCustomVerificationEmailTemplates_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListCustomVerificationEmailTemplates) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListCustomVerificationEmailTemplates) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListCustomVerificationEmailTemplates) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListCustomVerificationEmailTemplates) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListCustomVerificationEmailTemplates) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListCustomVerificationEmailTemplates) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListCustomVerificationEmailTemplates) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListCustomVerificationEmailTemplates) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListCustomVerificationEmailTemplates) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListCustomVerificationEmailTemplates) 

# ListDedicatedIpPools
<a name="API_ListDedicatedIpPools"></a>

List all of the dedicated IP pools that exist in your AWS account in the current Region.

## Request Syntax
<a name="API_ListDedicatedIpPools_RequestSyntax"></a>

```
GET /v2/email/dedicated-ip-pools?NextToken=NextToken&PageSize=PageSize HTTP/1.1
```

## URI Request Parameters
<a name="API_ListDedicatedIpPools_RequestParameters"></a>

The request uses the following URI parameters.

 ** [NextToken](#API_ListDedicatedIpPools_RequestSyntax) **   <a name="SES-ListDedicatedIpPools-request-uri-NextToken"></a>
A token returned from a previous call to `ListDedicatedIpPools` to indicate the position in the list of dedicated IP pools.

 ** [PageSize](#API_ListDedicatedIpPools_RequestSyntax) **   <a name="SES-ListDedicatedIpPools-request-uri-PageSize"></a>
The number of results to show in a single call to `ListDedicatedIpPools`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.

## Request Body
<a name="API_ListDedicatedIpPools_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListDedicatedIpPools_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DedicatedIpPools": [ "string" ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListDedicatedIpPools_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DedicatedIpPools](#API_ListDedicatedIpPools_ResponseSyntax) **   <a name="SES-ListDedicatedIpPools-response-DedicatedIpPools"></a>
A list of all of the dedicated IP pools that are associated with your AWS account in the current Region.  
Type: Array of strings

 ** [NextToken](#API_ListDedicatedIpPools_ResponseSyntax) **   <a name="SES-ListDedicatedIpPools-response-NextToken"></a>
A token that indicates that there are additional IP pools to list. To view additional IP pools, issue another request to `ListDedicatedIpPools`, passing this token in the `NextToken` parameter.  
Type: String

## Errors
<a name="API_ListDedicatedIpPools_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListDedicatedIpPools_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListDedicatedIpPools) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListDedicatedIpPools) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListDedicatedIpPools) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListDedicatedIpPools) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListDedicatedIpPools) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListDedicatedIpPools) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListDedicatedIpPools) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListDedicatedIpPools) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListDedicatedIpPools) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListDedicatedIpPools) 

# ListDeliverabilityTestReports
<a name="API_ListDeliverabilityTestReports"></a>

Show a list of the predictive inbox placement tests that you've performed, regardless of their statuses. For predictive inbox placement tests that are complete, you can use the `GetDeliverabilityTestReport` operation to view the results.

## Request Syntax
<a name="API_ListDeliverabilityTestReports_RequestSyntax"></a>

```
GET /v2/email/deliverability-dashboard/test-reports?NextToken=NextToken&PageSize=PageSize HTTP/1.1
```

## URI Request Parameters
<a name="API_ListDeliverabilityTestReports_RequestParameters"></a>

The request uses the following URI parameters.

 ** [NextToken](#API_ListDeliverabilityTestReports_RequestSyntax) **   <a name="SES-ListDeliverabilityTestReports-request-uri-NextToken"></a>
A token returned from a previous call to `ListDeliverabilityTestReports` to indicate the position in the list of predictive inbox placement tests.

 ** [PageSize](#API_ListDeliverabilityTestReports_RequestSyntax) **   <a name="SES-ListDeliverabilityTestReports-request-uri-PageSize"></a>
The number of results to show in a single call to `ListDeliverabilityTestReports`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.  
The value you specify has to be at least 0, and can be no more than 1000.

## Request Body
<a name="API_ListDeliverabilityTestReports_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListDeliverabilityTestReports_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DeliverabilityTestReports": [ 
      { 
         "CreateDate": number,
         "DeliverabilityTestStatus": "string",
         "FromEmailAddress": "string",
         "ReportId": "string",
         "ReportName": "string",
         "Subject": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListDeliverabilityTestReports_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DeliverabilityTestReports](#API_ListDeliverabilityTestReports_ResponseSyntax) **   <a name="SES-ListDeliverabilityTestReports-response-DeliverabilityTestReports"></a>
An object that contains a lists of predictive inbox placement tests that you've performed.  
Type: Array of [DeliverabilityTestReport](API_DeliverabilityTestReport.md) objects

 ** [NextToken](#API_ListDeliverabilityTestReports_ResponseSyntax) **   <a name="SES-ListDeliverabilityTestReports-response-NextToken"></a>
A token that indicates that there are additional predictive inbox placement tests to list. To view additional predictive inbox placement tests, issue another request to `ListDeliverabilityTestReports`, and pass this token in the `NextToken` parameter.  
Type: String

## Errors
<a name="API_ListDeliverabilityTestReports_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListDeliverabilityTestReports_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListDeliverabilityTestReports) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListDeliverabilityTestReports) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListDeliverabilityTestReports) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListDeliverabilityTestReports) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListDeliverabilityTestReports) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListDeliverabilityTestReports) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListDeliverabilityTestReports) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListDeliverabilityTestReports) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListDeliverabilityTestReports) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListDeliverabilityTestReports) 

# ListDomainDeliverabilityCampaigns
<a name="API_ListDomainDeliverabilityCampaigns"></a>

Retrieve deliverability data for all the campaigns that used a specific domain to send email during a specified time range. This data is available for a domain only if you enabled the Deliverability dashboard for the domain.

## Request Syntax
<a name="API_ListDomainDeliverabilityCampaigns_RequestSyntax"></a>

```
GET /v2/email/deliverability-dashboard/domains/SubscribedDomain/campaigns?EndDate=EndDate&NextToken=NextToken&PageSize=PageSize&StartDate=StartDate HTTP/1.1
```

## URI Request Parameters
<a name="API_ListDomainDeliverabilityCampaigns_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EndDate](#API_ListDomainDeliverabilityCampaigns_RequestSyntax) **   <a name="SES-ListDomainDeliverabilityCampaigns-request-uri-EndDate"></a>
The last day that you want to obtain deliverability data for. This value has to be less than or equal to 30 days after the value of the `StartDate` parameter.  
Required: Yes

 ** [NextToken](#API_ListDomainDeliverabilityCampaigns_RequestSyntax) **   <a name="SES-ListDomainDeliverabilityCampaigns-request-uri-NextToken"></a>
A token that’s returned from a previous call to the `ListDomainDeliverabilityCampaigns` operation. This token indicates the position of a campaign in the list of campaigns.

 ** [PageSize](#API_ListDomainDeliverabilityCampaigns_RequestSyntax) **   <a name="SES-ListDomainDeliverabilityCampaigns-request-uri-PageSize"></a>
The maximum number of results to include in response to a single call to the `ListDomainDeliverabilityCampaigns` operation. If the number of results is larger than the number that you specify in this parameter, the response includes a `NextToken` element, which you can use to obtain additional results.

 ** [StartDate](#API_ListDomainDeliverabilityCampaigns_RequestSyntax) **   <a name="SES-ListDomainDeliverabilityCampaigns-request-uri-StartDate"></a>
The first day that you want to obtain deliverability data for.  
Required: Yes

 ** [SubscribedDomain](#API_ListDomainDeliverabilityCampaigns_RequestSyntax) **   <a name="SES-ListDomainDeliverabilityCampaigns-request-uri-SubscribedDomain"></a>
The domain to obtain deliverability data for.  
Required: Yes

## Request Body
<a name="API_ListDomainDeliverabilityCampaigns_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListDomainDeliverabilityCampaigns_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DomainDeliverabilityCampaigns": [ 
      { 
         "CampaignId": "string",
         "DeleteRate": number,
         "Esps": [ "string" ],
         "FirstSeenDateTime": number,
         "FromAddress": "string",
         "ImageUrl": "string",
         "InboxCount": number,
         "LastSeenDateTime": number,
         "ProjectedVolume": number,
         "ReadDeleteRate": number,
         "ReadRate": number,
         "SendingIps": [ "string" ],
         "SpamCount": number,
         "Subject": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListDomainDeliverabilityCampaigns_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DomainDeliverabilityCampaigns](#API_ListDomainDeliverabilityCampaigns_ResponseSyntax) **   <a name="SES-ListDomainDeliverabilityCampaigns-response-DomainDeliverabilityCampaigns"></a>
An array of responses, one for each campaign that used the domain to send email during the specified time range.  
Type: Array of [DomainDeliverabilityCampaign](API_DomainDeliverabilityCampaign.md) objects

 ** [NextToken](#API_ListDomainDeliverabilityCampaigns_ResponseSyntax) **   <a name="SES-ListDomainDeliverabilityCampaigns-response-NextToken"></a>
A token that’s returned from a previous call to the `ListDomainDeliverabilityCampaigns` operation. This token indicates the position of the campaign in the list of campaigns.  
Type: String

## Errors
<a name="API_ListDomainDeliverabilityCampaigns_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListDomainDeliverabilityCampaigns_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListDomainDeliverabilityCampaigns) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListDomainDeliverabilityCampaigns) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListDomainDeliverabilityCampaigns) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListDomainDeliverabilityCampaigns) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListDomainDeliverabilityCampaigns) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListDomainDeliverabilityCampaigns) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListDomainDeliverabilityCampaigns) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListDomainDeliverabilityCampaigns) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListDomainDeliverabilityCampaigns) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListDomainDeliverabilityCampaigns) 

# ListEmailIdentities
<a name="API_ListEmailIdentities"></a>

Returns a list of all of the email identities that are associated with your AWS account. An identity can be either an email address or a domain. This operation returns identities that are verified as well as those that aren't. This operation returns identities that are associated with Amazon SES and Amazon Pinpoint.

## Request Syntax
<a name="API_ListEmailIdentities_RequestSyntax"></a>

```
GET /v2/email/identities?NextToken=NextToken&PageSize=PageSize HTTP/1.1
```

## URI Request Parameters
<a name="API_ListEmailIdentities_RequestParameters"></a>

The request uses the following URI parameters.

 ** [NextToken](#API_ListEmailIdentities_RequestSyntax) **   <a name="SES-ListEmailIdentities-request-uri-NextToken"></a>
A token returned from a previous call to `ListEmailIdentities` to indicate the position in the list of identities.

 ** [PageSize](#API_ListEmailIdentities_RequestSyntax) **   <a name="SES-ListEmailIdentities-request-uri-PageSize"></a>
The number of results to show in a single call to `ListEmailIdentities`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.  
The value you specify has to be at least 0, and can be no more than 1000.

## Request Body
<a name="API_ListEmailIdentities_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListEmailIdentities_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "EmailIdentities": [ 
      { 
         "IdentityName": "string",
         "IdentityType": "string",
         "SendingEnabled": boolean,
         "VerificationStatus": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListEmailIdentities_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [EmailIdentities](#API_ListEmailIdentities_ResponseSyntax) **   <a name="SES-ListEmailIdentities-response-EmailIdentities"></a>
An array that includes all of the email identities associated with your AWS account.  
Type: Array of [IdentityInfo](API_IdentityInfo.md) objects

 ** [NextToken](#API_ListEmailIdentities_ResponseSyntax) **   <a name="SES-ListEmailIdentities-response-NextToken"></a>
A token that indicates that there are additional configuration sets to list. To view additional configuration sets, issue another request to `ListEmailIdentities`, and pass this token in the `NextToken` parameter.  
Type: String

## Errors
<a name="API_ListEmailIdentities_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListEmailIdentities_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListEmailIdentities) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListEmailIdentities) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListEmailIdentities) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListEmailIdentities) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListEmailIdentities) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListEmailIdentities) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListEmailIdentities) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListEmailIdentities) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListEmailIdentities) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListEmailIdentities) 

# ListEmailTemplates
<a name="API_ListEmailTemplates"></a>

Lists the email templates present in your Amazon SES account in the current AWS Region.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_ListEmailTemplates_RequestSyntax"></a>

```
GET /v2/email/templates?NextToken=NextToken&PageSize=PageSize HTTP/1.1
```

## URI Request Parameters
<a name="API_ListEmailTemplates_RequestParameters"></a>

The request uses the following URI parameters.

 ** [NextToken](#API_ListEmailTemplates_RequestSyntax) **   <a name="SES-ListEmailTemplates-request-uri-NextToken"></a>
A token returned from a previous call to `ListEmailTemplates` to indicate the position in the list of email templates.

 ** [PageSize](#API_ListEmailTemplates_RequestSyntax) **   <a name="SES-ListEmailTemplates-request-uri-PageSize"></a>
The number of results to show in a single call to `ListEmailTemplates`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.  
The value you specify has to be at least 1, and can be no more than 100.

## Request Body
<a name="API_ListEmailTemplates_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListEmailTemplates_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "TemplatesMetadata": [ 
      { 
         "CreatedTimestamp": number,
         "TemplateName": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListEmailTemplates_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_ListEmailTemplates_ResponseSyntax) **   <a name="SES-ListEmailTemplates-response-NextToken"></a>
A token indicating that there are additional email templates available to be listed. Pass this token to a subsequent `ListEmailTemplates` call to retrieve the next 10 email templates.  
Type: String

 ** [TemplatesMetadata](#API_ListEmailTemplates_ResponseSyntax) **   <a name="SES-ListEmailTemplates-response-TemplatesMetadata"></a>
An array the contains the name and creation time stamp for each template in your Amazon SES account.  
Type: Array of [EmailTemplateMetadata](API_EmailTemplateMetadata.md) objects

## Errors
<a name="API_ListEmailTemplates_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListEmailTemplates_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListEmailTemplates) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListEmailTemplates) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListEmailTemplates) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListEmailTemplates) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListEmailTemplates) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListEmailTemplates) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListEmailTemplates) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListEmailTemplates) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListEmailTemplates) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListEmailTemplates) 

# ListExportJobs
<a name="API_ListExportJobs"></a>

Lists all of the export jobs.

## Request Syntax
<a name="API_ListExportJobs_RequestSyntax"></a>

```
POST /v2/email/list-export-jobs HTTP/1.1
Content-type: application/json

{
   "ExportSourceType": "string",
   "JobStatus": "string",
   "NextToken": "string",
   "PageSize": number
}
```

## URI Request Parameters
<a name="API_ListExportJobs_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListExportJobs_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ExportSourceType](#API_ListExportJobs_RequestSyntax) **   <a name="SES-ListExportJobs-request-ExportSourceType"></a>
A value used to list export jobs that have a certain `ExportSourceType`.  
Type: String  
Valid Values: `METRICS_DATA | MESSAGE_INSIGHTS`   
Required: No

 ** [JobStatus](#API_ListExportJobs_RequestSyntax) **   <a name="SES-ListExportJobs-request-JobStatus"></a>
A value used to list export jobs that have a certain `JobStatus`.  
Type: String  
Valid Values: `CREATED | PROCESSING | COMPLETED | FAILED | CANCELLED`   
Required: No

 ** [NextToken](#API_ListExportJobs_RequestSyntax) **   <a name="SES-ListExportJobs-request-NextToken"></a>
The pagination token returned from a previous call to `ListExportJobs` to indicate the position in the list of export jobs.  
Type: String  
Required: No

 ** [PageSize](#API_ListExportJobs_RequestSyntax) **   <a name="SES-ListExportJobs-request-PageSize"></a>
Maximum number of export jobs to return at once. Use this parameter to paginate results. If additional export jobs exist beyond the specified limit, the `NextToken` element is sent in the response. Use the `NextToken` value in subsequent calls to `ListExportJobs` to retrieve additional export jobs.  
Type: Integer  
Required: No

## Response Syntax
<a name="API_ListExportJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ExportJobs": [ 
      { 
         "CompletedTimestamp": number,
         "CreatedTimestamp": number,
         "ExportSourceType": "string",
         "JobId": "string",
         "JobStatus": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListExportJobs_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ExportJobs](#API_ListExportJobs_ResponseSyntax) **   <a name="SES-ListExportJobs-response-ExportJobs"></a>
A list of the export job summaries.  
Type: Array of [ExportJobSummary](API_ExportJobSummary.md) objects

 ** [NextToken](#API_ListExportJobs_ResponseSyntax) **   <a name="SES-ListExportJobs-response-NextToken"></a>
A string token indicating that there might be additional export jobs available to be listed. Use this token to a subsequent call to `ListExportJobs` with the same parameters to retrieve the next page of export jobs.  
Type: String

## Errors
<a name="API_ListExportJobs_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListExportJobs_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListExportJobs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListExportJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListExportJobs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListExportJobs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListExportJobs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListExportJobs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListExportJobs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListExportJobs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListExportJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListExportJobs) 

# ListImportJobs
<a name="API_ListImportJobs"></a>

Lists all of the import jobs.

## Request Syntax
<a name="API_ListImportJobs_RequestSyntax"></a>

```
POST /v2/email/import-jobs/list HTTP/1.1
Content-type: application/json

{
   "ImportDestinationType": "string",
   "NextToken": "string",
   "PageSize": number
}
```

## URI Request Parameters
<a name="API_ListImportJobs_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListImportJobs_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ImportDestinationType](#API_ListImportJobs_RequestSyntax) **   <a name="SES-ListImportJobs-request-ImportDestinationType"></a>
The destination of the import job, which can be used to list import jobs that have a certain `ImportDestinationType`.  
Type: String  
Valid Values: `SUPPRESSION_LIST | CONTACT_LIST`   
Required: No

 ** [NextToken](#API_ListImportJobs_RequestSyntax) **   <a name="SES-ListImportJobs-request-NextToken"></a>
A string token indicating that there might be additional import jobs available to be listed. Copy this token to a subsequent call to `ListImportJobs` with the same parameters to retrieve the next page of import jobs.  
Type: String  
Required: No

 ** [PageSize](#API_ListImportJobs_RequestSyntax) **   <a name="SES-ListImportJobs-request-PageSize"></a>
Maximum number of import jobs to return at once. Use this parameter to paginate results. If additional import jobs exist beyond the specified limit, the `NextToken` element is sent in the response. Use the `NextToken` value in subsequent requests to retrieve additional addresses.  
Type: Integer  
Required: No

## Response Syntax
<a name="API_ListImportJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ImportJobs": [ 
      { 
         "CreatedTimestamp": number,
         "FailedRecordsCount": number,
         "ImportDestination": { 
            "ContactListDestination": { 
               "ContactListImportAction": "string",
               "ContactListName": "string"
            },
            "SuppressionListDestination": { 
               "SuppressionListImportAction": "string"
            }
         },
         "JobId": "string",
         "JobStatus": "string",
         "ProcessedRecordsCount": number
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListImportJobs_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ImportJobs](#API_ListImportJobs_ResponseSyntax) **   <a name="SES-ListImportJobs-response-ImportJobs"></a>
A list of the import job summaries.  
Type: Array of [ImportJobSummary](API_ImportJobSummary.md) objects

 ** [NextToken](#API_ListImportJobs_ResponseSyntax) **   <a name="SES-ListImportJobs-response-NextToken"></a>
A string token indicating that there might be additional import jobs available to be listed. Copy this token to a subsequent call to `ListImportJobs` with the same parameters to retrieve the next page of import jobs.  
Type: String

## Errors
<a name="API_ListImportJobs_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListImportJobs_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListImportJobs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListImportJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListImportJobs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListImportJobs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListImportJobs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListImportJobs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListImportJobs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListImportJobs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListImportJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListImportJobs) 

# ListMultiRegionEndpoints
<a name="API_ListMultiRegionEndpoints"></a>

List the multi-region endpoints (global-endpoints).

Only multi-region endpoints (global-endpoints) whose primary region is the AWS-Region where operation is executed will be listed.

## Request Syntax
<a name="API_ListMultiRegionEndpoints_RequestSyntax"></a>

```
GET /v2/email/multi-region-endpoints?NextToken=NextToken&PageSize=PageSize HTTP/1.1
```

## URI Request Parameters
<a name="API_ListMultiRegionEndpoints_RequestParameters"></a>

The request uses the following URI parameters.

 ** [NextToken](#API_ListMultiRegionEndpoints_RequestSyntax) **   <a name="SES-ListMultiRegionEndpoints-request-uri-NextToken"></a>
A token returned from a previous call to `ListMultiRegionEndpoints` to indicate the position in the list of multi-region endpoints (global-endpoints).  
Length Constraints: Minimum length of 1. Maximum length of 5000.  
Pattern: `^^([A-Za-z0-9+/]{4})*([A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$` 

 ** [PageSize](#API_ListMultiRegionEndpoints_RequestSyntax) **   <a name="SES-ListMultiRegionEndpoints-request-uri-PageSize"></a>
The number of results to show in a single call to `ListMultiRegionEndpoints`. If the number of results is larger than the number you specified in this parameter, the response includes a `NextToken` element that you can use to retrieve the next page of results.   
Valid Range: Minimum value of 1. Maximum value of 1000.

## Request Body
<a name="API_ListMultiRegionEndpoints_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListMultiRegionEndpoints_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "MultiRegionEndpoints": [ 
      { 
         "CreatedTimestamp": number,
         "EndpointId": "string",
         "EndpointName": "string",
         "LastUpdatedTimestamp": number,
         "Regions": [ "string" ],
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListMultiRegionEndpoints_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [MultiRegionEndpoints](#API_ListMultiRegionEndpoints_ResponseSyntax) **   <a name="SES-ListMultiRegionEndpoints-response-MultiRegionEndpoints"></a>
An array that contains key multi-region endpoint (global-endpoint) properties.  
Type: Array of [MultiRegionEndpoint](API_MultiRegionEndpoint.md) objects

 ** [NextToken](#API_ListMultiRegionEndpoints_ResponseSyntax) **   <a name="SES-ListMultiRegionEndpoints-response-NextToken"></a>
A token indicating that there are additional multi-region endpoints (global-endpoints) available to be listed. Pass this token to a subsequent `ListMultiRegionEndpoints` call to retrieve the next page.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 5000.  
Pattern: `^^([A-Za-z0-9+/]{4})*([A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$` 

## Errors
<a name="API_ListMultiRegionEndpoints_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListMultiRegionEndpoints_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListMultiRegionEndpoints) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListMultiRegionEndpoints) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListMultiRegionEndpoints) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListMultiRegionEndpoints) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListMultiRegionEndpoints) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListMultiRegionEndpoints) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListMultiRegionEndpoints) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListMultiRegionEndpoints) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListMultiRegionEndpoints) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListMultiRegionEndpoints) 

# ListRecommendations
<a name="API_ListRecommendations"></a>

Lists the recommendations present in your Amazon SES account in the current AWS Region.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_ListRecommendations_RequestSyntax"></a>

```
POST /v2/email/vdm/recommendations HTTP/1.1
Content-type: application/json

{
   "Filter": { 
      "string" : "string" 
   },
   "NextToken": "string",
   "PageSize": number
}
```

## URI Request Parameters
<a name="API_ListRecommendations_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListRecommendations_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Filter](#API_ListRecommendations_RequestSyntax) **   <a name="SES-ListRecommendations-request-Filter"></a>
Filters applied when retrieving recommendations. Can eiter be an individual filter, or combinations of `STATUS` and `IMPACT` or `STATUS` and `TYPE`   
Type: String to string map  
Map Entries: Maximum number of 2 items.  
Valid Keys: `TYPE | IMPACT | STATUS | RESOURCE_ARN`   
Value Length Constraints: Minimum length of 1. Maximum length of 512.  
Required: No

 ** [NextToken](#API_ListRecommendations_RequestSyntax) **   <a name="SES-ListRecommendations-request-NextToken"></a>
A token returned from a previous call to `ListRecommendations` to indicate the position in the list of recommendations.  
Type: String  
Required: No

 ** [PageSize](#API_ListRecommendations_RequestSyntax) **   <a name="SES-ListRecommendations-request-PageSize"></a>
The number of results to show in a single call to `ListRecommendations`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.  
The value you specify has to be at least 1, and can be no more than 100.  
Type: Integer  
Required: No

## Response Syntax
<a name="API_ListRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Recommendations": [ 
      { 
         "CreatedTimestamp": number,
         "Description": "string",
         "Impact": "string",
         "LastUpdatedTimestamp": number,
         "ResourceArn": "string",
         "Status": "string",
         "Type": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListRecommendations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_ListRecommendations_ResponseSyntax) **   <a name="SES-ListRecommendations-response-NextToken"></a>
A string token indicating that there might be additional recommendations available to be listed. Use the token provided in the `ListRecommendationsResponse` to use in the subsequent call to `ListRecommendations` with the same parameters to retrieve the next page of recommendations.  
Type: String

 ** [Recommendations](#API_ListRecommendations_ResponseSyntax) **   <a name="SES-ListRecommendations-response-Recommendations"></a>
The recommendations applicable to your account.  
Type: Array of [Recommendation](API_Recommendation.md) objects

## Errors
<a name="API_ListRecommendations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListRecommendations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListRecommendations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListRecommendations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListRecommendations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListRecommendations) 

# ListReputationEntities
<a name="API_ListReputationEntities"></a>

List reputation entities in your Amazon SES account in the current AWS Region. You can filter the results by entity type, reputation impact, sending status, or entity reference prefix.

 *Reputation entities* represent resources in your account that have reputation tracking and management capabilities. Use this operation to get an overview of all entities and their current reputation status.

## Request Syntax
<a name="API_ListReputationEntities_RequestSyntax"></a>

```
POST /v2/email/reputation/entities HTTP/1.1
Content-type: application/json

{
   "Filter": { 
      "string" : "string" 
   },
   "NextToken": "string",
   "PageSize": number
}
```

## URI Request Parameters
<a name="API_ListReputationEntities_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListReputationEntities_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Filter](#API_ListReputationEntities_RequestSyntax) **   <a name="SES-ListReputationEntities-request-Filter"></a>
An object that contains filters to apply when listing reputation entities. You can filter by entity type, reputation impact, sending status, or entity reference prefix.  
Type: String to string map  
Valid Keys: `ENTITY_TYPE | REPUTATION_IMPACT | SENDING_STATUS | ENTITY_REFERENCE_PREFIX`   
Value Length Constraints: Minimum length of 1. Maximum length of 512.  
Required: No

 ** [NextToken](#API_ListReputationEntities_RequestSyntax) **   <a name="SES-ListReputationEntities-request-NextToken"></a>
A token returned from a previous call to `ListReputationEntities` to indicate the position in the list of reputation entities.  
Type: String  
Required: No

 ** [PageSize](#API_ListReputationEntities_RequestSyntax) **   <a name="SES-ListReputationEntities-request-PageSize"></a>
The number of results to show in a single call to `ListReputationEntities`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.  
Type: Integer  
Required: No

## Response Syntax
<a name="API_ListReputationEntities_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "ReputationEntities": [ 
      { 
         "AwsSesManagedStatus": { 
            "Cause": "string",
            "LastUpdatedTimestamp": number,
            "Status": "string"
         },
         "CustomerManagedStatus": { 
            "Cause": "string",
            "LastUpdatedTimestamp": number,
            "Status": "string"
         },
         "ReputationEntityReference": "string",
         "ReputationEntityType": "string",
         "ReputationImpact": "string",
         "ReputationManagementPolicy": "string",
         "SendingStatusAggregate": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListReputationEntities_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_ListReputationEntities_ResponseSyntax) **   <a name="SES-ListReputationEntities-response-NextToken"></a>
A token that indicates that there are additional reputation entities to list. To view additional reputation entities, issue another request to `ListReputationEntities`, and pass this token in the `NextToken` parameter.  
Type: String

 ** [ReputationEntities](#API_ListReputationEntities_ResponseSyntax) **   <a name="SES-ListReputationEntities-response-ReputationEntities"></a>
An array that contains information about the reputation entities in your account.  
Type: Array of [ReputationEntity](API_ReputationEntity.md) objects

## Errors
<a name="API_ListReputationEntities_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListReputationEntities_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListReputationEntities) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListReputationEntities) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListReputationEntities) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListReputationEntities) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListReputationEntities) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListReputationEntities) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListReputationEntities) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListReputationEntities) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListReputationEntities) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListReputationEntities) 

# ListResourceTenants
<a name="API_ListResourceTenants"></a>

List all tenants associated with a specific resource.

This operation returns a list of tenants that are associated with the specified resource. This is useful for understanding which tenants are currently using a particular resource such as an email identity, configuration set, or email template.

## Request Syntax
<a name="API_ListResourceTenants_RequestSyntax"></a>

```
POST /v2/email/resources/tenants/list HTTP/1.1
Content-type: application/json

{
   "NextToken": "string",
   "PageSize": number,
   "ResourceArn": "string"
}
```

## URI Request Parameters
<a name="API_ListResourceTenants_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListResourceTenants_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [NextToken](#API_ListResourceTenants_RequestSyntax) **   <a name="SES-ListResourceTenants-request-NextToken"></a>
A token returned from a previous call to `ListResourceTenants` to indicate the position in the list of resource tenants.  
Type: String  
Required: No

 ** [PageSize](#API_ListResourceTenants_RequestSyntax) **   <a name="SES-ListResourceTenants-request-PageSize"></a>
The number of results to show in a single call to `ListResourceTenants`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.  
Type: Integer  
Required: No

 ** [ResourceArn](#API_ListResourceTenants_RequestSyntax) **   <a name="SES-ListResourceTenants-request-ResourceArn"></a>
The Amazon Resource Name (ARN) of the resource to list associated tenants for.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_ListResourceTenants_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "ResourceTenants": [ 
      { 
         "AssociatedTimestamp": number,
         "ResourceArn": "string",
         "TenantId": "string",
         "TenantName": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListResourceTenants_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_ListResourceTenants_ResponseSyntax) **   <a name="SES-ListResourceTenants-response-NextToken"></a>
A token that indicates that there are additional tenants to list. To view additional tenants, issue another request to `ListResourceTenants`, and pass this token in the `NextToken` parameter.  
Type: String

 ** [ResourceTenants](#API_ListResourceTenants_ResponseSyntax) **   <a name="SES-ListResourceTenants-response-ResourceTenants"></a>
An array that contains information about each tenant associated with the resource.  
Type: Array of [ResourceTenantMetadata](API_ResourceTenantMetadata.md) objects

## Errors
<a name="API_ListResourceTenants_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListResourceTenants_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListResourceTenants) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListResourceTenants) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListResourceTenants) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListResourceTenants) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListResourceTenants) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListResourceTenants) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListResourceTenants) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListResourceTenants) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListResourceTenants) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListResourceTenants) 

# ListSuppressedDestinations
<a name="API_ListSuppressedDestinations"></a>

Retrieves a list of email addresses that are on the suppression list for your account.

## Request Syntax
<a name="API_ListSuppressedDestinations_RequestSyntax"></a>

```
GET /v2/email/suppression/addresses?EndDate=EndDate&NextToken=NextToken&PageSize=PageSize&Reason=Reasons&StartDate=StartDate HTTP/1.1
```

## URI Request Parameters
<a name="API_ListSuppressedDestinations_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EndDate](#API_ListSuppressedDestinations_RequestSyntax) **   <a name="SES-ListSuppressedDestinations-request-uri-EndDate"></a>
Used to filter the list of suppressed email destinations so that it only includes addresses that were added to the list before a specific date.

 ** [NextToken](#API_ListSuppressedDestinations_RequestSyntax) **   <a name="SES-ListSuppressedDestinations-request-uri-NextToken"></a>
A token returned from a previous call to `ListSuppressedDestinations` to indicate the position in the list of suppressed email addresses.

 ** [PageSize](#API_ListSuppressedDestinations_RequestSyntax) **   <a name="SES-ListSuppressedDestinations-request-uri-PageSize"></a>
The number of results to show in a single call to `ListSuppressedDestinations`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.

 ** [Reasons](#API_ListSuppressedDestinations_RequestSyntax) **   <a name="SES-ListSuppressedDestinations-request-uri-Reasons"></a>
The factors that caused the email address to be added to .  
Valid Values: `BOUNCE | COMPLAINT` 

 ** [StartDate](#API_ListSuppressedDestinations_RequestSyntax) **   <a name="SES-ListSuppressedDestinations-request-uri-StartDate"></a>
Used to filter the list of suppressed email destinations so that it only includes addresses that were added to the list after a specific date.

## Request Body
<a name="API_ListSuppressedDestinations_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListSuppressedDestinations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "SuppressedDestinationSummaries": [ 
      { 
         "EmailAddress": "string",
         "LastUpdateTime": number,
         "Reason": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListSuppressedDestinations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_ListSuppressedDestinations_ResponseSyntax) **   <a name="SES-ListSuppressedDestinations-response-NextToken"></a>
A token that indicates that there are additional email addresses on the suppression list for your account. To view additional suppressed addresses, issue another request to `ListSuppressedDestinations`, and pass this token in the `NextToken` parameter.  
Type: String

 ** [SuppressedDestinationSummaries](#API_ListSuppressedDestinations_ResponseSyntax) **   <a name="SES-ListSuppressedDestinations-response-SuppressedDestinationSummaries"></a>
A list of summaries, each containing a summary for a suppressed email destination.  
Type: Array of [SuppressedDestinationSummary](API_SuppressedDestinationSummary.md) objects

## Errors
<a name="API_ListSuppressedDestinations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** InvalidNextTokenException **   
The specified request includes an invalid or expired token.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListSuppressedDestinations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListSuppressedDestinations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListSuppressedDestinations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListSuppressedDestinations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListSuppressedDestinations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListSuppressedDestinations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListSuppressedDestinations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListSuppressedDestinations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListSuppressedDestinations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListSuppressedDestinations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListSuppressedDestinations) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Retrieve a list of the tags (keys and values) that are associated with a specified resource. A *tag* is a label that you optionally define and associate with a resource. Each tag consists of a required *tag key* and an optional associated *tag value*. A tag key is a general label that acts as a category for more specific tag values. A tag value acts as a descriptor within a tag key.

## Request Syntax
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
GET /v2/email/tags?ResourceArn=ResourceArn HTTP/1.1
```

## URI Request Parameters
<a name="API_ListTagsForResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ResourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="SES-ListTagsForResource-request-uri-ResourceArn"></a>
The Amazon Resource Name (ARN) of the resource that you want to retrieve tag information for.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_ListTagsForResource_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListTagsForResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="SES-ListTagsForResource-response-Tags"></a>
An array that lists all the tags that are associated with the resource. Each tag consists of a required tag key (`Key`) and an associated tag value (`Value`)  
Type: Array of [Tag](API_Tag.md) objects

## Errors
<a name="API_ListTagsForResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListTagsForResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListTagsForResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListTagsForResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListTagsForResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListTagsForResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListTagsForResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListTagsForResource) 

# ListTenantResources
<a name="API_ListTenantResources"></a>

List all resources associated with a specific tenant.

This operation returns a list of resources (email identities, configuration sets, or email templates) that are associated with the specified tenant. You can optionally filter the results by resource type.

## Request Syntax
<a name="API_ListTenantResources_RequestSyntax"></a>

```
POST /v2/email/tenants/resources/list HTTP/1.1
Content-type: application/json

{
   "Filter": { 
      "string" : "string" 
   },
   "NextToken": "string",
   "PageSize": number,
   "TenantName": "string"
}
```

## URI Request Parameters
<a name="API_ListTenantResources_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListTenantResources_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Filter](#API_ListTenantResources_RequestSyntax) **   <a name="SES-ListTenantResources-request-Filter"></a>
A map of filter keys and values for filtering the list of tenant resources. Currently, the only supported filter key is `RESOURCE_TYPE`.  
Type: String to string map  
Valid Keys: `RESOURCE_TYPE`   
Value Length Constraints: Minimum length of 1. Maximum length of 512.  
Required: No

 ** [NextToken](#API_ListTenantResources_RequestSyntax) **   <a name="SES-ListTenantResources-request-NextToken"></a>
A token returned from a previous call to `ListTenantResources` to indicate the position in the list of tenant resources.  
Type: String  
Required: No

 ** [PageSize](#API_ListTenantResources_RequestSyntax) **   <a name="SES-ListTenantResources-request-PageSize"></a>
The number of results to show in a single call to `ListTenantResources`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.  
Type: Integer  
Required: No

 ** [TenantName](#API_ListTenantResources_RequestSyntax) **   <a name="SES-ListTenantResources-request-TenantName"></a>
The name of the tenant to list resources for.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_ListTenantResources_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "TenantResources": [ 
      { 
         "ResourceArn": "string",
         "ResourceType": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListTenantResources_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_ListTenantResources_ResponseSyntax) **   <a name="SES-ListTenantResources-response-NextToken"></a>
A token that indicates that there are additional resources to list. To view additional resources, issue another request to `ListTenantResources`, and pass this token in the `NextToken` parameter.  
Type: String

 ** [TenantResources](#API_ListTenantResources_ResponseSyntax) **   <a name="SES-ListTenantResources-response-TenantResources"></a>
An array that contains information about each resource associated with the tenant.  
Type: Array of [TenantResource](API_TenantResource.md) objects

## Errors
<a name="API_ListTenantResources_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListTenantResources_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListTenantResources) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListTenantResources) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListTenantResources) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListTenantResources) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListTenantResources) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListTenantResources) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListTenantResources) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListTenantResources) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListTenantResources) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListTenantResources) 

# ListTenants
<a name="API_ListTenants"></a>

List all tenants associated with your account in the current AWS Region.

This operation returns basic information about each tenant, such as tenant name, ID, ARN, and creation timestamp.

## Request Syntax
<a name="API_ListTenants_RequestSyntax"></a>

```
POST /v2/email/tenants/list HTTP/1.1
Content-type: application/json

{
   "NextToken": "string",
   "PageSize": number
}
```

## URI Request Parameters
<a name="API_ListTenants_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListTenants_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [NextToken](#API_ListTenants_RequestSyntax) **   <a name="SES-ListTenants-request-NextToken"></a>
A token returned from a previous call to `ListTenants` to indicate the position in the list of tenants.  
Type: String  
Required: No

 ** [PageSize](#API_ListTenants_RequestSyntax) **   <a name="SES-ListTenants-request-PageSize"></a>
The number of results to show in a single call to `ListTenants`. If the number of results is larger than the number you specified in this parameter, then the response includes a `NextToken` element, which you can use to obtain additional results.  
Type: Integer  
Required: No

## Response Syntax
<a name="API_ListTenants_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Tenants": [ 
      { 
         "CreatedTimestamp": number,
         "TenantArn": "string",
         "TenantId": "string",
         "TenantName": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListTenants_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_ListTenants_ResponseSyntax) **   <a name="SES-ListTenants-response-NextToken"></a>
A token that indicates that there are additional tenants to list. To view additional tenants, issue another request to `ListTenants`, and pass this token in the `NextToken` parameter.  
Type: String

 ** [Tenants](#API_ListTenants_ResponseSyntax) **   <a name="SES-ListTenants-response-Tenants"></a>
An array that contains basic information about each tenant.  
Type: Array of [TenantInfo](API_TenantInfo.md) objects

## Errors
<a name="API_ListTenants_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_ListTenants_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/ListTenants) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/ListTenants) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListTenants) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/ListTenants) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListTenants) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/ListTenants) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/ListTenants) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/ListTenants) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/ListTenants) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListTenants) 

# PutAccountDedicatedIpWarmupAttributes
<a name="API_PutAccountDedicatedIpWarmupAttributes"></a>

Enable or disable the automatic warm-up feature for dedicated IP addresses.

## Request Syntax
<a name="API_PutAccountDedicatedIpWarmupAttributes_RequestSyntax"></a>

```
PUT /v2/email/account/dedicated-ips/warmup HTTP/1.1
Content-type: application/json

{
   "AutoWarmupEnabled": boolean
}
```

## URI Request Parameters
<a name="API_PutAccountDedicatedIpWarmupAttributes_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_PutAccountDedicatedIpWarmupAttributes_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AutoWarmupEnabled](#API_PutAccountDedicatedIpWarmupAttributes_RequestSyntax) **   <a name="SES-PutAccountDedicatedIpWarmupAttributes-request-AutoWarmupEnabled"></a>
Enables or disables the automatic warm-up feature for dedicated IP addresses that are associated with your Amazon SES account in the current AWS Region. Set to `true` to enable the automatic warm-up feature, or set to `false` to disable it.  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_PutAccountDedicatedIpWarmupAttributes_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutAccountDedicatedIpWarmupAttributes_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutAccountDedicatedIpWarmupAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutAccountDedicatedIpWarmupAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutAccountDedicatedIpWarmupAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutAccountDedicatedIpWarmupAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutAccountDedicatedIpWarmupAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutAccountDedicatedIpWarmupAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutAccountDedicatedIpWarmupAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutAccountDedicatedIpWarmupAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutAccountDedicatedIpWarmupAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutAccountDedicatedIpWarmupAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutAccountDedicatedIpWarmupAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutAccountDedicatedIpWarmupAttributes) 

# PutAccountDetails
<a name="API_PutAccountDetails"></a>

Update your Amazon SES account details.

## Request Syntax
<a name="API_PutAccountDetails_RequestSyntax"></a>

```
POST /v2/email/account/details HTTP/1.1
Content-type: application/json

{
   "AdditionalContactEmailAddresses": [ "string" ],
   "ContactLanguage": "string",
   "MailType": "string",
   "ProductionAccessEnabled": boolean,
   "UseCaseDescription": "string",
   "WebsiteURL": "string"
}
```

## URI Request Parameters
<a name="API_PutAccountDetails_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_PutAccountDetails_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AdditionalContactEmailAddresses](#API_PutAccountDetails_RequestSyntax) **   <a name="SES-PutAccountDetails-request-AdditionalContactEmailAddresses"></a>
Additional email addresses that you would like to be notified regarding Amazon SES matters.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 4 items.  
Length Constraints: Minimum length of 6. Maximum length of 254.  
Pattern: `^(.+)@(.+)$`   
Required: No

 ** [ContactLanguage](#API_PutAccountDetails_RequestSyntax) **   <a name="SES-PutAccountDetails-request-ContactLanguage"></a>
The language you would prefer to be contacted with.  
Type: String  
Valid Values: `EN | JA`   
Required: No

 ** [MailType](#API_PutAccountDetails_RequestSyntax) **   <a name="SES-PutAccountDetails-request-MailType"></a>
The type of email your account will send.  
Type: String  
Valid Values: `MARKETING | TRANSACTIONAL`   
Required: Yes

 ** [ProductionAccessEnabled](#API_PutAccountDetails_RequestSyntax) **   <a name="SES-PutAccountDetails-request-ProductionAccessEnabled"></a>
Indicates whether or not your account should have production access in the current AWS Region.  
If the value is `false`, then your account is in the *sandbox*. When your account is in the sandbox, you can only send email to verified identities.   
If the value is `true`, then your account has production access. When your account has production access, you can send email to any address. The sending quota and maximum sending rate for your account vary based on your specific use case.  
Type: Boolean  
Required: No

 ** [UseCaseDescription](#API_PutAccountDetails_RequestSyntax) **   <a name="SES-PutAccountDetails-request-UseCaseDescription"></a>
 *This parameter has been deprecated.*   
A description of the types of email that you plan to send.  
Type: String  
Length Constraints: Maximum length of 5000.  
Required: No

 ** [WebsiteURL](#API_PutAccountDetails_RequestSyntax) **   <a name="SES-PutAccountDetails-request-WebsiteURL"></a>
The URL of your website. This information helps us better understand the type of content that you plan to send.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1000.  
Pattern: `^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?`   
Required: Yes

## Response Syntax
<a name="API_PutAccountDetails_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutAccountDetails_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutAccountDetails_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConflictException **   
If there is already an ongoing account details update under review.  
HTTP Status Code: 409

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutAccountDetails_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutAccountDetails) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutAccountDetails) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutAccountDetails) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutAccountDetails) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutAccountDetails) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutAccountDetails) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutAccountDetails) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutAccountDetails) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutAccountDetails) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutAccountDetails) 

# PutAccountSendingAttributes
<a name="API_PutAccountSendingAttributes"></a>

Enable or disable the ability of your account to send email.

## Request Syntax
<a name="API_PutAccountSendingAttributes_RequestSyntax"></a>

```
PUT /v2/email/account/sending HTTP/1.1
Content-type: application/json

{
   "SendingEnabled": boolean
}
```

## URI Request Parameters
<a name="API_PutAccountSendingAttributes_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_PutAccountSendingAttributes_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [SendingEnabled](#API_PutAccountSendingAttributes_RequestSyntax) **   <a name="SES-PutAccountSendingAttributes-request-SendingEnabled"></a>
Enables or disables your account's ability to send email. Set to `true` to enable email sending, or set to `false` to disable email sending.  
If AWS paused your account's ability to send email, you can't use this operation to resume your account's ability to send email.
Type: Boolean  
Required: No

## Response Syntax
<a name="API_PutAccountSendingAttributes_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutAccountSendingAttributes_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutAccountSendingAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutAccountSendingAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutAccountSendingAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutAccountSendingAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutAccountSendingAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutAccountSendingAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutAccountSendingAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutAccountSendingAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutAccountSendingAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutAccountSendingAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutAccountSendingAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutAccountSendingAttributes) 

# PutAccountSuppressionAttributes
<a name="API_PutAccountSuppressionAttributes"></a>

Change the settings for the account-level suppression list.

## Request Syntax
<a name="API_PutAccountSuppressionAttributes_RequestSyntax"></a>

```
PUT /v2/email/account/suppression HTTP/1.1
Content-type: application/json

{
   "SuppressedReasons": [ "string" ],
   "ValidationAttributes": { 
      "ConditionThreshold": { 
         "ConditionThresholdEnabled": "string",
         "OverallConfidenceThreshold": { 
            "ConfidenceVerdictThreshold": "string"
         }
      }
   }
}
```

## URI Request Parameters
<a name="API_PutAccountSuppressionAttributes_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_PutAccountSuppressionAttributes_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [SuppressedReasons](#API_PutAccountSuppressionAttributes_RequestSyntax) **   <a name="SES-PutAccountSuppressionAttributes-request-SuppressedReasons"></a>
A list that contains the reasons that email addresses will be automatically added to the suppression list for your account. This list can contain any or all of the following:  
+  `COMPLAINT` – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a complaint.
+  `BOUNCE` – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a hard bounce.
Type: Array of strings  
Valid Values: `BOUNCE | COMPLAINT`   
Required: No

 ** [ValidationAttributes](#API_PutAccountSuppressionAttributes_RequestSyntax) **   <a name="SES-PutAccountSuppressionAttributes-request-ValidationAttributes"></a>
An object that contains additional suppression attributes for your account.  
Type: [SuppressionValidationAttributes](API_SuppressionValidationAttributes.md) object  
Required: No

## Response Syntax
<a name="API_PutAccountSuppressionAttributes_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutAccountSuppressionAttributes_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutAccountSuppressionAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutAccountSuppressionAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutAccountSuppressionAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutAccountSuppressionAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutAccountSuppressionAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutAccountSuppressionAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutAccountSuppressionAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutAccountSuppressionAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutAccountSuppressionAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutAccountSuppressionAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutAccountSuppressionAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutAccountSuppressionAttributes) 

# PutAccountVdmAttributes
<a name="API_PutAccountVdmAttributes"></a>

Update your Amazon SES account VDM attributes.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_PutAccountVdmAttributes_RequestSyntax"></a>

```
PUT /v2/email/account/vdm HTTP/1.1
Content-type: application/json

{
   "VdmAttributes": { 
      "DashboardAttributes": { 
         "EngagementMetrics": "string"
      },
      "GuardianAttributes": { 
         "OptimizedSharedDelivery": "string"
      },
      "VdmEnabled": "string"
   }
}
```

## URI Request Parameters
<a name="API_PutAccountVdmAttributes_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_PutAccountVdmAttributes_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [VdmAttributes](#API_PutAccountVdmAttributes_RequestSyntax) **   <a name="SES-PutAccountVdmAttributes-request-VdmAttributes"></a>
The VDM attributes that you wish to apply to your Amazon SES account.  
Type: [VdmAttributes](API_VdmAttributes.md) object  
Required: Yes

## Response Syntax
<a name="API_PutAccountVdmAttributes_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutAccountVdmAttributes_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutAccountVdmAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutAccountVdmAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutAccountVdmAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutAccountVdmAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutAccountVdmAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutAccountVdmAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutAccountVdmAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutAccountVdmAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutAccountVdmAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutAccountVdmAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutAccountVdmAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutAccountVdmAttributes) 

# PutConfigurationSetArchivingOptions
<a name="API_PutConfigurationSetArchivingOptions"></a>

Associate the configuration set with a MailManager archive. When you send email using the `SendEmail` or `SendBulkEmail` operations the message as it will be given to the receiving SMTP server will be archived, along with the recipient information.

## Request Syntax
<a name="API_PutConfigurationSetArchivingOptions_RequestSyntax"></a>

```
PUT /v2/email/configuration-sets/ConfigurationSetName/archiving-options HTTP/1.1
Content-type: application/json

{
   "ArchiveArn": "string"
}
```

## URI Request Parameters
<a name="API_PutConfigurationSetArchivingOptions_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_PutConfigurationSetArchivingOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetArchivingOptions-request-uri-ConfigurationSetName"></a>
The name of the configuration set to associate with a MailManager archive.  
Required: Yes

## Request Body
<a name="API_PutConfigurationSetArchivingOptions_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ArchiveArn](#API_PutConfigurationSetArchivingOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetArchivingOptions-request-ArchiveArn"></a>
The Amazon Resource Name (ARN) of the MailManager archive that the Amazon SES API v2 sends email to.  
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 1011.  
Pattern: `arn:(aws|aws-[a-z-]+):ses:[a-z]{2,4}-[a-z-]+-[0-9]:[0-9]{1,20}:mailmanager-archive/a-[a-z0-9]{24,62}`   
Required: No

## Response Syntax
<a name="API_PutConfigurationSetArchivingOptions_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutConfigurationSetArchivingOptions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutConfigurationSetArchivingOptions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutConfigurationSetArchivingOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutConfigurationSetArchivingOptions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutConfigurationSetArchivingOptions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutConfigurationSetArchivingOptions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutConfigurationSetArchivingOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutConfigurationSetArchivingOptions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutConfigurationSetArchivingOptions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutConfigurationSetArchivingOptions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutConfigurationSetArchivingOptions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutConfigurationSetArchivingOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutConfigurationSetArchivingOptions) 

# PutConfigurationSetDeliveryOptions
<a name="API_PutConfigurationSetDeliveryOptions"></a>

Associate a configuration set with a dedicated IP pool. You can use dedicated IP pools to create groups of dedicated IP addresses for sending specific types of email.

## Request Syntax
<a name="API_PutConfigurationSetDeliveryOptions_RequestSyntax"></a>

```
PUT /v2/email/configuration-sets/ConfigurationSetName/delivery-options HTTP/1.1
Content-type: application/json

{
   "MaxDeliverySeconds": number,
   "SendingPoolName": "string",
   "TlsPolicy": "string"
}
```

## URI Request Parameters
<a name="API_PutConfigurationSetDeliveryOptions_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_PutConfigurationSetDeliveryOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetDeliveryOptions-request-uri-ConfigurationSetName"></a>
The name of the configuration set to associate with a dedicated IP pool.  
Required: Yes

## Request Body
<a name="API_PutConfigurationSetDeliveryOptions_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [MaxDeliverySeconds](#API_PutConfigurationSetDeliveryOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetDeliveryOptions-request-MaxDeliverySeconds"></a>
The maximum amount of time, in seconds, that Amazon SES API v2 will attempt delivery of email. If specified, the value must greater than or equal to 300 seconds (5 minutes) and less than or equal to 50400 seconds (840 minutes).   
Type: Long  
Valid Range: Minimum value of 300. Maximum value of 50400.  
Required: No

 ** [SendingPoolName](#API_PutConfigurationSetDeliveryOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetDeliveryOptions-request-SendingPoolName"></a>
The name of the dedicated IP pool to associate with the configuration set.  
Type: String  
Required: No

 ** [TlsPolicy](#API_PutConfigurationSetDeliveryOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetDeliveryOptions-request-TlsPolicy"></a>
Specifies whether messages that use the configuration set are required to use Transport Layer Security (TLS). If the value is `Require`, messages are only delivered if a TLS connection can be established. If the value is `Optional`, messages can be delivered in plain text if a TLS connection can't be established.  
Type: String  
Valid Values: `REQUIRE | OPTIONAL`   
Required: No

## Response Syntax
<a name="API_PutConfigurationSetDeliveryOptions_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutConfigurationSetDeliveryOptions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutConfigurationSetDeliveryOptions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutConfigurationSetDeliveryOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutConfigurationSetDeliveryOptions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutConfigurationSetDeliveryOptions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutConfigurationSetDeliveryOptions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutConfigurationSetDeliveryOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutConfigurationSetDeliveryOptions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutConfigurationSetDeliveryOptions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutConfigurationSetDeliveryOptions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutConfigurationSetDeliveryOptions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutConfigurationSetDeliveryOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutConfigurationSetDeliveryOptions) 

# PutConfigurationSetReputationOptions
<a name="API_PutConfigurationSetReputationOptions"></a>

Enable or disable collection of reputation metrics for emails that you send using a particular configuration set in a specific AWS Region.

## Request Syntax
<a name="API_PutConfigurationSetReputationOptions_RequestSyntax"></a>

```
PUT /v2/email/configuration-sets/ConfigurationSetName/reputation-options HTTP/1.1
Content-type: application/json

{
   "ReputationMetricsEnabled": boolean
}
```

## URI Request Parameters
<a name="API_PutConfigurationSetReputationOptions_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_PutConfigurationSetReputationOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetReputationOptions-request-uri-ConfigurationSetName"></a>
The name of the configuration set.  
Required: Yes

## Request Body
<a name="API_PutConfigurationSetReputationOptions_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ReputationMetricsEnabled](#API_PutConfigurationSetReputationOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetReputationOptions-request-ReputationMetricsEnabled"></a>
If `true`, tracking of reputation metrics is enabled for the configuration set. If `false`, tracking of reputation metrics is disabled for the configuration set.  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_PutConfigurationSetReputationOptions_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutConfigurationSetReputationOptions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutConfigurationSetReputationOptions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutConfigurationSetReputationOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutConfigurationSetReputationOptions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutConfigurationSetReputationOptions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutConfigurationSetReputationOptions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutConfigurationSetReputationOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutConfigurationSetReputationOptions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutConfigurationSetReputationOptions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutConfigurationSetReputationOptions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutConfigurationSetReputationOptions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutConfigurationSetReputationOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutConfigurationSetReputationOptions) 

# PutConfigurationSetSendingOptions
<a name="API_PutConfigurationSetSendingOptions"></a>

Enable or disable email sending for messages that use a particular configuration set in a specific AWS Region.

## Request Syntax
<a name="API_PutConfigurationSetSendingOptions_RequestSyntax"></a>

```
PUT /v2/email/configuration-sets/ConfigurationSetName/sending HTTP/1.1
Content-type: application/json

{
   "SendingEnabled": boolean
}
```

## URI Request Parameters
<a name="API_PutConfigurationSetSendingOptions_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_PutConfigurationSetSendingOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetSendingOptions-request-uri-ConfigurationSetName"></a>
The name of the configuration set to enable or disable email sending for.  
Required: Yes

## Request Body
<a name="API_PutConfigurationSetSendingOptions_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [SendingEnabled](#API_PutConfigurationSetSendingOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetSendingOptions-request-SendingEnabled"></a>
If `true`, email sending is enabled for the configuration set. If `false`, email sending is disabled for the configuration set.  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_PutConfigurationSetSendingOptions_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutConfigurationSetSendingOptions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutConfigurationSetSendingOptions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutConfigurationSetSendingOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutConfigurationSetSendingOptions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutConfigurationSetSendingOptions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutConfigurationSetSendingOptions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutConfigurationSetSendingOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutConfigurationSetSendingOptions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutConfigurationSetSendingOptions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutConfigurationSetSendingOptions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutConfigurationSetSendingOptions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutConfigurationSetSendingOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutConfigurationSetSendingOptions) 

# PutConfigurationSetSuppressionOptions
<a name="API_PutConfigurationSetSuppressionOptions"></a>

Specify the account suppression list preferences for a configuration set.

## Request Syntax
<a name="API_PutConfigurationSetSuppressionOptions_RequestSyntax"></a>

```
PUT /v2/email/configuration-sets/ConfigurationSetName/suppression-options HTTP/1.1
Content-type: application/json

{
   "SuppressedReasons": [ "string" ],
   "ValidationOptions": { 
      "ConditionThreshold": { 
         "ConditionThresholdEnabled": "string",
         "OverallConfidenceThreshold": { 
            "ConfidenceVerdictThreshold": "string"
         }
      }
   }
}
```

## URI Request Parameters
<a name="API_PutConfigurationSetSuppressionOptions_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_PutConfigurationSetSuppressionOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetSuppressionOptions-request-uri-ConfigurationSetName"></a>
The name of the configuration set to change the suppression list preferences for.  
Required: Yes

## Request Body
<a name="API_PutConfigurationSetSuppressionOptions_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [SuppressedReasons](#API_PutConfigurationSetSuppressionOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetSuppressionOptions-request-SuppressedReasons"></a>
A list that contains the reasons that email addresses are automatically added to the suppression list for your account. This list can contain any or all of the following:  
+  `COMPLAINT` – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a complaint.
+  `BOUNCE` – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a hard bounce.
Type: Array of strings  
Valid Values: `BOUNCE | COMPLAINT`   
Required: No

 ** [ValidationOptions](#API_PutConfigurationSetSuppressionOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetSuppressionOptions-request-ValidationOptions"></a>
An object that contains information about the email address suppression preferences for the configuration set in the current AWS Region.  
Type: [SuppressionValidationOptions](API_SuppressionValidationOptions.md) object  
Required: No

## Response Syntax
<a name="API_PutConfigurationSetSuppressionOptions_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutConfigurationSetSuppressionOptions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutConfigurationSetSuppressionOptions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutConfigurationSetSuppressionOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutConfigurationSetSuppressionOptions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutConfigurationSetSuppressionOptions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutConfigurationSetSuppressionOptions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutConfigurationSetSuppressionOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutConfigurationSetSuppressionOptions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutConfigurationSetSuppressionOptions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutConfigurationSetSuppressionOptions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutConfigurationSetSuppressionOptions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutConfigurationSetSuppressionOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutConfigurationSetSuppressionOptions) 

# PutConfigurationSetTrackingOptions
<a name="API_PutConfigurationSetTrackingOptions"></a>

Specify a custom domain to use for open and click tracking elements in email that you send.

## Request Syntax
<a name="API_PutConfigurationSetTrackingOptions_RequestSyntax"></a>

```
PUT /v2/email/configuration-sets/ConfigurationSetName/tracking-options HTTP/1.1
Content-type: application/json

{
   "CustomRedirectDomain": "string",
   "HttpsPolicy": "string"
}
```

## URI Request Parameters
<a name="API_PutConfigurationSetTrackingOptions_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_PutConfigurationSetTrackingOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetTrackingOptions-request-uri-ConfigurationSetName"></a>
The name of the configuration set.  
Required: Yes

## Request Body
<a name="API_PutConfigurationSetTrackingOptions_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [CustomRedirectDomain](#API_PutConfigurationSetTrackingOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetTrackingOptions-request-CustomRedirectDomain"></a>
The domain to use to track open and click events.  
Type: String  
Required: No

 ** [HttpsPolicy](#API_PutConfigurationSetTrackingOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetTrackingOptions-request-HttpsPolicy"></a>
The https policy to use for tracking open and click events. If the value is OPTIONAL or HttpsPolicy is not specified, the open trackers use HTTP and click tracker use the original protocol of the link. If the value is REQUIRE, both open and click tracker uses HTTPS and if the value is REQUIRE\$1OPEN\$1ONLY open tracker uses HTTPS and link tracker is same as original protocol of the link.   
Type: String  
Valid Values: `REQUIRE | REQUIRE_OPEN_ONLY | OPTIONAL`   
Required: No

## Response Syntax
<a name="API_PutConfigurationSetTrackingOptions_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutConfigurationSetTrackingOptions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutConfigurationSetTrackingOptions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutConfigurationSetTrackingOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutConfigurationSetTrackingOptions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutConfigurationSetTrackingOptions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutConfigurationSetTrackingOptions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutConfigurationSetTrackingOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutConfigurationSetTrackingOptions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutConfigurationSetTrackingOptions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutConfigurationSetTrackingOptions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutConfigurationSetTrackingOptions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutConfigurationSetTrackingOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutConfigurationSetTrackingOptions) 

# PutConfigurationSetVdmOptions
<a name="API_PutConfigurationSetVdmOptions"></a>

Specify VDM preferences for email that you send using the configuration set.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_PutConfigurationSetVdmOptions_RequestSyntax"></a>

```
PUT /v2/email/configuration-sets/ConfigurationSetName/vdm-options HTTP/1.1
Content-type: application/json

{
   "VdmOptions": { 
      "DashboardOptions": { 
         "EngagementMetrics": "string"
      },
      "GuardianOptions": { 
         "OptimizedSharedDelivery": "string"
      }
   }
}
```

## URI Request Parameters
<a name="API_PutConfigurationSetVdmOptions_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_PutConfigurationSetVdmOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetVdmOptions-request-uri-ConfigurationSetName"></a>
The name of the configuration set.  
Required: Yes

## Request Body
<a name="API_PutConfigurationSetVdmOptions_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [VdmOptions](#API_PutConfigurationSetVdmOptions_RequestSyntax) **   <a name="SES-PutConfigurationSetVdmOptions-request-VdmOptions"></a>
The VDM options to apply to the configuration set.  
Type: [VdmOptions](API_VdmOptions.md) object  
Required: No

## Response Syntax
<a name="API_PutConfigurationSetVdmOptions_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutConfigurationSetVdmOptions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutConfigurationSetVdmOptions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutConfigurationSetVdmOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutConfigurationSetVdmOptions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutConfigurationSetVdmOptions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutConfigurationSetVdmOptions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutConfigurationSetVdmOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutConfigurationSetVdmOptions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutConfigurationSetVdmOptions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutConfigurationSetVdmOptions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutConfigurationSetVdmOptions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutConfigurationSetVdmOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutConfigurationSetVdmOptions) 

# PutDedicatedIpInPool
<a name="API_PutDedicatedIpInPool"></a>

Move a dedicated IP address to an existing dedicated IP pool.

**Note**  
The dedicated IP address that you specify must already exist, and must be associated with your AWS account.   
The dedicated IP pool you specify must already exist. You can create a new pool by using the `CreateDedicatedIpPool` operation.

## Request Syntax
<a name="API_PutDedicatedIpInPool_RequestSyntax"></a>

```
PUT /v2/email/dedicated-ips/IP/pool HTTP/1.1
Content-type: application/json

{
   "DestinationPoolName": "string"
}
```

## URI Request Parameters
<a name="API_PutDedicatedIpInPool_RequestParameters"></a>

The request uses the following URI parameters.

 ** [IP](#API_PutDedicatedIpInPool_RequestSyntax) **   <a name="SES-PutDedicatedIpInPool-request-uri-Ip"></a>
The IP address that you want to move to the dedicated IP pool. The value you specify has to be a dedicated IP address that's associated with your AWS account.  
Required: Yes

## Request Body
<a name="API_PutDedicatedIpInPool_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [DestinationPoolName](#API_PutDedicatedIpInPool_RequestSyntax) **   <a name="SES-PutDedicatedIpInPool-request-DestinationPoolName"></a>
The name of the IP pool that you want to add the dedicated IP address to. You have to specify an IP pool that already exists.  
Type: String  
Required: Yes

## Response Syntax
<a name="API_PutDedicatedIpInPool_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutDedicatedIpInPool_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutDedicatedIpInPool_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutDedicatedIpInPool_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutDedicatedIpInPool) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutDedicatedIpInPool) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutDedicatedIpInPool) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutDedicatedIpInPool) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutDedicatedIpInPool) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutDedicatedIpInPool) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutDedicatedIpInPool) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutDedicatedIpInPool) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutDedicatedIpInPool) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutDedicatedIpInPool) 

# PutDedicatedIpPoolScalingAttributes
<a name="API_PutDedicatedIpPoolScalingAttributes"></a>

Used to convert a dedicated IP pool to a different scaling mode.

**Note**  
 `MANAGED` pools cannot be converted to `STANDARD` scaling mode.

## Request Syntax
<a name="API_PutDedicatedIpPoolScalingAttributes_RequestSyntax"></a>

```
PUT /v2/email/dedicated-ip-pools/PoolName/scaling HTTP/1.1
Content-type: application/json

{
   "ScalingMode": "string"
}
```

## URI Request Parameters
<a name="API_PutDedicatedIpPoolScalingAttributes_RequestParameters"></a>

The request uses the following URI parameters.

 ** [PoolName](#API_PutDedicatedIpPoolScalingAttributes_RequestSyntax) **   <a name="SES-PutDedicatedIpPoolScalingAttributes-request-uri-PoolName"></a>
The name of the dedicated IP pool.  
Required: Yes

## Request Body
<a name="API_PutDedicatedIpPoolScalingAttributes_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ScalingMode](#API_PutDedicatedIpPoolScalingAttributes_RequestSyntax) **   <a name="SES-PutDedicatedIpPoolScalingAttributes-request-ScalingMode"></a>
The scaling mode to apply to the dedicated IP pool.  
Changing the scaling mode from `MANAGED` to `STANDARD` is not supported.
Type: String  
Valid Values: `STANDARD | MANAGED`   
Required: Yes

## Response Syntax
<a name="API_PutDedicatedIpPoolScalingAttributes_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutDedicatedIpPoolScalingAttributes_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutDedicatedIpPoolScalingAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutDedicatedIpPoolScalingAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutDedicatedIpPoolScalingAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutDedicatedIpPoolScalingAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutDedicatedIpPoolScalingAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutDedicatedIpPoolScalingAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutDedicatedIpPoolScalingAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutDedicatedIpPoolScalingAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutDedicatedIpPoolScalingAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutDedicatedIpPoolScalingAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutDedicatedIpPoolScalingAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutDedicatedIpPoolScalingAttributes) 

# PutDedicatedIpWarmupAttributes
<a name="API_PutDedicatedIpWarmupAttributes"></a>



## Request Syntax
<a name="API_PutDedicatedIpWarmupAttributes_RequestSyntax"></a>

```
PUT /v2/email/dedicated-ips/IP/warmup HTTP/1.1
Content-type: application/json

{
   "WarmupPercentage": number
}
```

## URI Request Parameters
<a name="API_PutDedicatedIpWarmupAttributes_RequestParameters"></a>

The request uses the following URI parameters.

 ** [IP](#API_PutDedicatedIpWarmupAttributes_RequestSyntax) **   <a name="SES-PutDedicatedIpWarmupAttributes-request-uri-Ip"></a>
The dedicated IP address that you want to update the warm-up attributes for.  
Required: Yes

## Request Body
<a name="API_PutDedicatedIpWarmupAttributes_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [WarmupPercentage](#API_PutDedicatedIpWarmupAttributes_RequestSyntax) **   <a name="SES-PutDedicatedIpWarmupAttributes-request-WarmupPercentage"></a>
The warm-up percentage that you want to associate with the dedicated IP address.  
Type: Integer  
Required: Yes

## Response Syntax
<a name="API_PutDedicatedIpWarmupAttributes_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutDedicatedIpWarmupAttributes_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutDedicatedIpWarmupAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutDedicatedIpWarmupAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutDedicatedIpWarmupAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutDedicatedIpWarmupAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutDedicatedIpWarmupAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutDedicatedIpWarmupAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutDedicatedIpWarmupAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutDedicatedIpWarmupAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutDedicatedIpWarmupAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutDedicatedIpWarmupAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutDedicatedIpWarmupAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutDedicatedIpWarmupAttributes) 

# PutDeliverabilityDashboardOption
<a name="API_PutDeliverabilityDashboardOption"></a>

Enable or disable the Deliverability dashboard. When you enable the Deliverability dashboard, you gain access to reputation, deliverability, and other metrics for the domains that you use to send email. You also gain the ability to perform predictive inbox placement tests.

When you use the Deliverability dashboard, you pay a monthly subscription charge, in addition to any other fees that you accrue by using Amazon SES and other AWS services. For more information about the features and cost of a Deliverability dashboard subscription, see [Amazon SES Pricing](http://aws.amazon.com/ses/pricing/).

## Request Syntax
<a name="API_PutDeliverabilityDashboardOption_RequestSyntax"></a>

```
PUT /v2/email/deliverability-dashboard HTTP/1.1
Content-type: application/json

{
   "DashboardEnabled": boolean,
   "SubscribedDomains": [ 
      { 
         "Domain": "string",
         "InboxPlacementTrackingOption": { 
            "Global": boolean,
            "TrackedIsps": [ "string" ]
         },
         "SubscriptionStartDate": number
      }
   ]
}
```

## URI Request Parameters
<a name="API_PutDeliverabilityDashboardOption_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_PutDeliverabilityDashboardOption_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [DashboardEnabled](#API_PutDeliverabilityDashboardOption_RequestSyntax) **   <a name="SES-PutDeliverabilityDashboardOption-request-DashboardEnabled"></a>
Specifies whether to enable the Deliverability dashboard. To enable the dashboard, set this value to `true`.  
Type: Boolean  
Required: Yes

 ** [SubscribedDomains](#API_PutDeliverabilityDashboardOption_RequestSyntax) **   <a name="SES-PutDeliverabilityDashboardOption-request-SubscribedDomains"></a>
An array of objects, one for each verified domain that you use to send email and enabled the Deliverability dashboard for.  
Type: Array of [DomainDeliverabilityTrackingOption](API_DomainDeliverabilityTrackingOption.md) objects  
Required: No

## Response Syntax
<a name="API_PutDeliverabilityDashboardOption_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutDeliverabilityDashboardOption_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutDeliverabilityDashboardOption_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AlreadyExistsException **   
The resource specified in your request already exists.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutDeliverabilityDashboardOption_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutDeliverabilityDashboardOption) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutDeliverabilityDashboardOption) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutDeliverabilityDashboardOption) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutDeliverabilityDashboardOption) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutDeliverabilityDashboardOption) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutDeliverabilityDashboardOption) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutDeliverabilityDashboardOption) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutDeliverabilityDashboardOption) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutDeliverabilityDashboardOption) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutDeliverabilityDashboardOption) 

# PutEmailIdentityConfigurationSetAttributes
<a name="API_PutEmailIdentityConfigurationSetAttributes"></a>

Used to associate a configuration set with an email identity.

## Request Syntax
<a name="API_PutEmailIdentityConfigurationSetAttributes_RequestSyntax"></a>

```
PUT /v2/email/identities/EmailIdentity/configuration-set HTTP/1.1
Content-type: application/json

{
   "ConfigurationSetName": "string"
}
```

## URI Request Parameters
<a name="API_PutEmailIdentityConfigurationSetAttributes_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailIdentity](#API_PutEmailIdentityConfigurationSetAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityConfigurationSetAttributes-request-uri-EmailIdentity"></a>
The email address or domain to associate with a configuration set.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_PutEmailIdentityConfigurationSetAttributes_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ConfigurationSetName](#API_PutEmailIdentityConfigurationSetAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityConfigurationSetAttributes-request-ConfigurationSetName"></a>
The configuration set to associate with an email identity.  
Type: String  
Required: No

## Response Syntax
<a name="API_PutEmailIdentityConfigurationSetAttributes_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutEmailIdentityConfigurationSetAttributes_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutEmailIdentityConfigurationSetAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutEmailIdentityConfigurationSetAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutEmailIdentityConfigurationSetAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutEmailIdentityConfigurationSetAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutEmailIdentityConfigurationSetAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutEmailIdentityConfigurationSetAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutEmailIdentityConfigurationSetAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutEmailIdentityConfigurationSetAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutEmailIdentityConfigurationSetAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutEmailIdentityConfigurationSetAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutEmailIdentityConfigurationSetAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutEmailIdentityConfigurationSetAttributes) 

# PutEmailIdentityDkimAttributes
<a name="API_PutEmailIdentityDkimAttributes"></a>

Used to enable or disable DKIM authentication for an email identity.

## Request Syntax
<a name="API_PutEmailIdentityDkimAttributes_RequestSyntax"></a>

```
PUT /v2/email/identities/EmailIdentity/dkim HTTP/1.1
Content-type: application/json

{
   "SigningEnabled": boolean
}
```

## URI Request Parameters
<a name="API_PutEmailIdentityDkimAttributes_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailIdentity](#API_PutEmailIdentityDkimAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityDkimAttributes-request-uri-EmailIdentity"></a>
The email identity.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_PutEmailIdentityDkimAttributes_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [SigningEnabled](#API_PutEmailIdentityDkimAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityDkimAttributes-request-SigningEnabled"></a>
Sets the DKIM signing configuration for the identity.  
When you set this value `true`, then the messages that are sent from the identity are signed using DKIM. If you set this value to `false`, your messages are sent without DKIM signing.  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_PutEmailIdentityDkimAttributes_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutEmailIdentityDkimAttributes_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutEmailIdentityDkimAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutEmailIdentityDkimAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutEmailIdentityDkimAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutEmailIdentityDkimAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutEmailIdentityDkimAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutEmailIdentityDkimAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutEmailIdentityDkimAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutEmailIdentityDkimAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutEmailIdentityDkimAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutEmailIdentityDkimAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutEmailIdentityDkimAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutEmailIdentityDkimAttributes) 

# PutEmailIdentityDkimSigningAttributes
<a name="API_PutEmailIdentityDkimSigningAttributes"></a>

Used to configure or change the DKIM authentication settings for an email domain identity. You can use this operation to do any of the following:
+ Update the signing attributes for an identity that uses Bring Your Own DKIM (BYODKIM).
+ Update the key length that should be used for Easy DKIM.
+ Change from using no DKIM authentication to using Easy DKIM.
+ Change from using no DKIM authentication to using BYODKIM.
+ Change from using Easy DKIM to using BYODKIM.
+ Change from using BYODKIM to using Easy DKIM.

## Request Syntax
<a name="API_PutEmailIdentityDkimSigningAttributes_RequestSyntax"></a>

```
PUT /v2/email/identities/EmailIdentity/dkim/signing HTTP/1.1
Content-type: application/json

{
   "SigningAttributes": { 
      "DomainSigningAttributesOrigin": "string",
      "DomainSigningPrivateKey": "string",
      "DomainSigningSelector": "string",
      "NextSigningKeyLength": "string"
   },
   "SigningAttributesOrigin": "string"
}
```

## URI Request Parameters
<a name="API_PutEmailIdentityDkimSigningAttributes_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailIdentity](#API_PutEmailIdentityDkimSigningAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityDkimSigningAttributes-request-uri-EmailIdentity"></a>
The email identity.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_PutEmailIdentityDkimSigningAttributes_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [SigningAttributes](#API_PutEmailIdentityDkimSigningAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityDkimSigningAttributes-request-SigningAttributes"></a>
An object that contains information about the private key and selector that you want to use to configure DKIM for the identity for Bring Your Own DKIM (BYODKIM) for the identity, or, configures the key length to be used for [Easy DKIM](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html).  
Type: [DkimSigningAttributes](API_DkimSigningAttributes.md) object  
Required: No

 ** [SigningAttributesOrigin](#API_PutEmailIdentityDkimSigningAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityDkimSigningAttributes-request-SigningAttributesOrigin"></a>
The method to use to configure DKIM for the identity. There are the following possible values:  
+  `AWS_SES` – Configure DKIM for the identity by using [Easy DKIM](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html).
+  `EXTERNAL` – Configure DKIM for the identity by using Bring Your Own DKIM (BYODKIM).
Type: String  
Valid Values: `AWS_SES | EXTERNAL | AWS_SES_AF_SOUTH_1 | AWS_SES_EU_NORTH_1 | AWS_SES_AP_SOUTH_1 | AWS_SES_EU_WEST_3 | AWS_SES_EU_WEST_2 | AWS_SES_EU_SOUTH_1 | AWS_SES_EU_WEST_1 | AWS_SES_AP_NORTHEAST_3 | AWS_SES_AP_NORTHEAST_2 | AWS_SES_ME_SOUTH_1 | AWS_SES_AP_NORTHEAST_1 | AWS_SES_IL_CENTRAL_1 | AWS_SES_SA_EAST_1 | AWS_SES_CA_CENTRAL_1 | AWS_SES_AP_SOUTHEAST_1 | AWS_SES_AP_SOUTHEAST_2 | AWS_SES_AP_SOUTHEAST_3 | AWS_SES_EU_CENTRAL_1 | AWS_SES_US_EAST_1 | AWS_SES_US_EAST_2 | AWS_SES_US_WEST_1 | AWS_SES_US_WEST_2 | AWS_SES_ME_CENTRAL_1 | AWS_SES_AP_SOUTH_2 | AWS_SES_EU_CENTRAL_2 | AWS_SES_AP_SOUTHEAST_5 | AWS_SES_CA_WEST_1`   
Required: Yes

## Response Syntax
<a name="API_PutEmailIdentityDkimSigningAttributes_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DkimStatus": "string",
   "DkimTokens": [ "string" ],
   "SigningHostedZone": "string"
}
```

## Response Elements
<a name="API_PutEmailIdentityDkimSigningAttributes_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DkimStatus](#API_PutEmailIdentityDkimSigningAttributes_ResponseSyntax) **   <a name="SES-PutEmailIdentityDkimSigningAttributes-response-DkimStatus"></a>
The DKIM authentication status of the identity. Amazon SES determines the authentication status by searching for specific records in the DNS configuration for your domain. If you used [Easy DKIM](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html) to set up DKIM authentication, Amazon SES tries to find three unique CNAME records in the DNS configuration for your domain.  
If you provided a public key to perform DKIM authentication, Amazon SES tries to find a TXT record that uses the selector that you specified. The value of the TXT record must be a public key that's paired with the private key that you specified in the process of creating the identity.  
The status can be one of the following:  
+  `PENDING` – The verification process was initiated, but Amazon SES hasn't yet detected the DKIM records in the DNS configuration for the domain.
+  `SUCCESS` – The verification process completed successfully.
+  `FAILED` – The verification process failed. This typically occurs when Amazon SES fails to find the DKIM records in the DNS configuration of the domain.
+  `TEMPORARY_FAILURE` – A temporary issue is preventing Amazon SES from determining the DKIM authentication status of the domain.
+  `NOT_STARTED` – The DKIM verification process hasn't been initiated for the domain.
Type: String  
Valid Values: `PENDING | SUCCESS | FAILED | TEMPORARY_FAILURE | NOT_STARTED` 

 ** [DkimTokens](#API_PutEmailIdentityDkimSigningAttributes_ResponseSyntax) **   <a name="SES-PutEmailIdentityDkimSigningAttributes-response-DkimTokens"></a>
If you used [Easy DKIM](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html) to configure DKIM authentication for the domain, then this object contains a set of unique strings that you use to create a set of CNAME records that you add to the DNS configuration for your domain. When Amazon SES detects these records in the DNS configuration for your domain, the DKIM authentication process is complete.  
If you configured DKIM authentication for the domain by providing your own public-private key pair, then this object contains the selector that's associated with your public key.  
Regardless of the DKIM authentication method you use, Amazon SES searches for the appropriate records in the DNS configuration of the domain for up to 72 hours.  
Type: Array of strings

 ** [SigningHostedZone](#API_PutEmailIdentityDkimSigningAttributes_ResponseSyntax) **   <a name="SES-PutEmailIdentityDkimSigningAttributes-response-SigningHostedZone"></a>
The hosted zone where Amazon SES publishes the DKIM public key TXT records for this email identity. This value indicates the DNS zone that customers must reference when configuring their CNAME records for DKIM authentication.  
When configuring DKIM for your domain, create CNAME records in your DNS that point to the selectors in this hosted zone. For example:  
 ` selector1._domainkey.yourdomain.com CNAME selector1.<SigningHostedZone> `   
 ` selector2._domainkey.yourdomain.com CNAME selector2.<SigningHostedZone> `   
 ` selector3._domainkey.yourdomain.com CNAME selector3.<SigningHostedZone> `   
Type: String

## Errors
<a name="API_PutEmailIdentityDkimSigningAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutEmailIdentityDkimSigningAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutEmailIdentityDkimSigningAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutEmailIdentityDkimSigningAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutEmailIdentityDkimSigningAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutEmailIdentityDkimSigningAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutEmailIdentityDkimSigningAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutEmailIdentityDkimSigningAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutEmailIdentityDkimSigningAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutEmailIdentityDkimSigningAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutEmailIdentityDkimSigningAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutEmailIdentityDkimSigningAttributes) 

# PutEmailIdentityFeedbackAttributes
<a name="API_PutEmailIdentityFeedbackAttributes"></a>

Used to enable or disable feedback forwarding for an identity. This setting determines what happens when an identity is used to send an email that results in a bounce or complaint event.

If the value is `true`, you receive email notifications when bounce or complaint events occur. These notifications are sent to the address that you specified in the `Return-Path` header of the original email.

You're required to have a method of tracking bounces and complaints. If you haven't set up another mechanism for receiving bounce or complaint notifications (for example, by setting up an event destination), you receive an email notification when these events occur (even if this setting is disabled).

## Request Syntax
<a name="API_PutEmailIdentityFeedbackAttributes_RequestSyntax"></a>

```
PUT /v2/email/identities/EmailIdentity/feedback HTTP/1.1
Content-type: application/json

{
   "EmailForwardingEnabled": boolean
}
```

## URI Request Parameters
<a name="API_PutEmailIdentityFeedbackAttributes_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailIdentity](#API_PutEmailIdentityFeedbackAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityFeedbackAttributes-request-uri-EmailIdentity"></a>
The email identity.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_PutEmailIdentityFeedbackAttributes_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [EmailForwardingEnabled](#API_PutEmailIdentityFeedbackAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityFeedbackAttributes-request-EmailForwardingEnabled"></a>
Sets the feedback forwarding configuration for the identity.  
If the value is `true`, you receive email notifications when bounce or complaint events occur. These notifications are sent to the address that you specified in the `Return-Path` header of the original email.  
You're required to have a method of tracking bounces and complaints. If you haven't set up another mechanism for receiving bounce or complaint notifications (for example, by setting up an event destination), you receive an email notification when these events occur (even if this setting is disabled).  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_PutEmailIdentityFeedbackAttributes_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutEmailIdentityFeedbackAttributes_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutEmailIdentityFeedbackAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutEmailIdentityFeedbackAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutEmailIdentityFeedbackAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutEmailIdentityFeedbackAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutEmailIdentityFeedbackAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutEmailIdentityFeedbackAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutEmailIdentityFeedbackAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutEmailIdentityFeedbackAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutEmailIdentityFeedbackAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutEmailIdentityFeedbackAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutEmailIdentityFeedbackAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutEmailIdentityFeedbackAttributes) 

# PutEmailIdentityMailFromAttributes
<a name="API_PutEmailIdentityMailFromAttributes"></a>

Used to enable or disable the custom Mail-From domain configuration for an email identity.

## Request Syntax
<a name="API_PutEmailIdentityMailFromAttributes_RequestSyntax"></a>

```
PUT /v2/email/identities/EmailIdentity/mail-from HTTP/1.1
Content-type: application/json

{
   "BehaviorOnMxFailure": "string",
   "MailFromDomain": "string"
}
```

## URI Request Parameters
<a name="API_PutEmailIdentityMailFromAttributes_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailIdentity](#API_PutEmailIdentityMailFromAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityMailFromAttributes-request-uri-EmailIdentity"></a>
The verified email identity.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_PutEmailIdentityMailFromAttributes_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [BehaviorOnMxFailure](#API_PutEmailIdentityMailFromAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityMailFromAttributes-request-BehaviorOnMxFailure"></a>
The action to take if the required MX record isn't found when you send an email. When you set this value to `UseDefaultValue`, the mail is sent using *amazonses.com* as the MAIL FROM domain. When you set this value to `RejectMessage`, the Amazon SES API v2 returns a `MailFromDomainNotVerified` error, and doesn't attempt to deliver the email.  
These behaviors are taken when the custom MAIL FROM domain configuration is in the `Pending`, `Failed`, and `TemporaryFailure` states.  
Type: String  
Valid Values: `USE_DEFAULT_VALUE | REJECT_MESSAGE`   
Required: No

 ** [MailFromDomain](#API_PutEmailIdentityMailFromAttributes_RequestSyntax) **   <a name="SES-PutEmailIdentityMailFromAttributes-request-MailFromDomain"></a>
 The custom MAIL FROM domain that you want the verified identity to use. The MAIL FROM domain must meet the following criteria:  
+ It has to be a subdomain of the verified identity.
+ It can't be used to receive email.
+ It can't be used in a "From" address if the MAIL FROM domain is a destination for feedback forwarding emails.
Type: String  
Required: No

## Response Syntax
<a name="API_PutEmailIdentityMailFromAttributes_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutEmailIdentityMailFromAttributes_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutEmailIdentityMailFromAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutEmailIdentityMailFromAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutEmailIdentityMailFromAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutEmailIdentityMailFromAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutEmailIdentityMailFromAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutEmailIdentityMailFromAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutEmailIdentityMailFromAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutEmailIdentityMailFromAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutEmailIdentityMailFromAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutEmailIdentityMailFromAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutEmailIdentityMailFromAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutEmailIdentityMailFromAttributes) 

# PutSuppressedDestination
<a name="API_PutSuppressedDestination"></a>

Adds an email address to the suppression list for your account.

## Request Syntax
<a name="API_PutSuppressedDestination_RequestSyntax"></a>

```
PUT /v2/email/suppression/addresses HTTP/1.1
Content-type: application/json

{
   "EmailAddress": "string",
   "Reason": "string"
}
```

## URI Request Parameters
<a name="API_PutSuppressedDestination_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_PutSuppressedDestination_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [EmailAddress](#API_PutSuppressedDestination_RequestSyntax) **   <a name="SES-PutSuppressedDestination-request-EmailAddress"></a>
The email address that should be added to the suppression list for your account.  
Type: String  
Required: Yes

 ** [Reason](#API_PutSuppressedDestination_RequestSyntax) **   <a name="SES-PutSuppressedDestination-request-Reason"></a>
The factors that should cause the email address to be added to the suppression list for your account.  
Type: String  
Valid Values: `BOUNCE | COMPLAINT`   
Required: Yes

## Response Syntax
<a name="API_PutSuppressedDestination_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutSuppressedDestination_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_PutSuppressedDestination_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_PutSuppressedDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/PutSuppressedDestination) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/PutSuppressedDestination) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PutSuppressedDestination) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/PutSuppressedDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PutSuppressedDestination) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/PutSuppressedDestination) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/PutSuppressedDestination) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/PutSuppressedDestination) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/PutSuppressedDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PutSuppressedDestination) 

# SendBulkEmail
<a name="API_SendBulkEmail"></a>

Composes an email message to multiple destinations.

## Request Syntax
<a name="API_SendBulkEmail_RequestSyntax"></a>

```
POST /v2/email/outbound-bulk-emails HTTP/1.1
Content-type: application/json

{
   "BulkEmailEntries": [ 
      { 
         "Destination": { 
            "BccAddresses": [ "string" ],
            "CcAddresses": [ "string" ],
            "ToAddresses": [ "string" ]
         },
         "ReplacementEmailContent": { 
            "ReplacementTemplate": { 
               "ReplacementTemplateData": "string"
            }
         },
         "ReplacementHeaders": [ 
            { 
               "Name": "string",
               "Value": "string"
            }
         ],
         "ReplacementTags": [ 
            { 
               "Name": "string",
               "Value": "string"
            }
         ]
      }
   ],
   "ConfigurationSetName": "string",
   "DefaultContent": { 
      "Template": { 
         "Attachments": [ 
            { 
               "ContentDescription": "string",
               "ContentDisposition": "string",
               "ContentId": "string",
               "ContentTransferEncoding": "string",
               "ContentType": "string",
               "FileName": "string",
               "RawContent": blob
            }
         ],
         "Headers": [ 
            { 
               "Name": "string",
               "Value": "string"
            }
         ],
         "TemplateArn": "string",
         "TemplateContent": { 
            "Html": "string",
            "Subject": "string",
            "Text": "string"
         },
         "TemplateData": "string",
         "TemplateName": "string"
      }
   },
   "DefaultEmailTags": [ 
      { 
         "Name": "string",
         "Value": "string"
      }
   ],
   "EndpointId": "string",
   "FeedbackForwardingEmailAddress": "string",
   "FeedbackForwardingEmailAddressIdentityArn": "string",
   "FromEmailAddress": "string",
   "FromEmailAddressIdentityArn": "string",
   "ReplyToAddresses": [ "string" ],
   "TenantName": "string"
}
```

## URI Request Parameters
<a name="API_SendBulkEmail_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_SendBulkEmail_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [BulkEmailEntries](#API_SendBulkEmail_RequestSyntax) **   <a name="SES-SendBulkEmail-request-BulkEmailEntries"></a>
The list of bulk email entry objects.  
Type: Array of [BulkEmailEntry](API_BulkEmailEntry.md) objects  
Required: Yes

 ** [ConfigurationSetName](#API_SendBulkEmail_RequestSyntax) **   <a name="SES-SendBulkEmail-request-ConfigurationSetName"></a>
The name of the configuration set to use when sending the email.  
Type: String  
Required: No

 ** [DefaultContent](#API_SendBulkEmail_RequestSyntax) **   <a name="SES-SendBulkEmail-request-DefaultContent"></a>
An object that contains the body of the message. You can specify a template message.  
Type: [BulkEmailContent](API_BulkEmailContent.md) object  
Required: Yes

 ** [DefaultEmailTags](#API_SendBulkEmail_RequestSyntax) **   <a name="SES-SendBulkEmail-request-DefaultEmailTags"></a>
A list of tags, in the form of name/value pairs, to apply to an email that you send using the `SendEmail` operation. Tags correspond to characteristics of the email that you define, so that you can publish email sending events.  
Type: Array of [MessageTag](API_MessageTag.md) objects  
Required: No

 ** [EndpointId](#API_SendBulkEmail_RequestSyntax) **   <a name="SES-SendBulkEmail-request-EndpointId"></a>
The ID of the multi-region endpoint (global-endpoint).  
Type: String  
Required: No

 ** [FeedbackForwardingEmailAddress](#API_SendBulkEmail_RequestSyntax) **   <a name="SES-SendBulkEmail-request-FeedbackForwardingEmailAddress"></a>
The address that you want bounce and complaint notifications to be sent to.  
Type: String  
Required: No

 ** [FeedbackForwardingEmailAddressIdentityArn](#API_SendBulkEmail_RequestSyntax) **   <a name="SES-SendBulkEmail-request-FeedbackForwardingEmailAddressIdentityArn"></a>
This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the `FeedbackForwardingEmailAddress` parameter.  
For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use feedback@example.com, then you would specify the `FeedbackForwardingEmailAddressIdentityArn` to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the `FeedbackForwardingEmailAddress` to be feedback@example.com.  
For more information about sending authorization, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html).  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** [FromEmailAddress](#API_SendBulkEmail_RequestSyntax) **   <a name="SES-SendBulkEmail-request-FromEmailAddress"></a>
The email address to use as the "From" address for the email. The address that you specify has to be verified.  
Type: String  
Required: No

 ** [FromEmailAddressIdentityArn](#API_SendBulkEmail_RequestSyntax) **   <a name="SES-SendBulkEmail-request-FromEmailAddressIdentityArn"></a>
This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the `FromEmailAddress` parameter.  
For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use sender@example.com, then you would specify the `FromEmailAddressIdentityArn` to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the `FromEmailAddress` to be sender@example.com.  
For more information about sending authorization, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html).  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** [ReplyToAddresses](#API_SendBulkEmail_RequestSyntax) **   <a name="SES-SendBulkEmail-request-ReplyToAddresses"></a>
The "Reply-to" email addresses for the message. When the recipient replies to the message, each Reply-to address receives the reply.  
Type: Array of strings  
Required: No

 ** [TenantName](#API_SendBulkEmail_RequestSyntax) **   <a name="SES-SendBulkEmail-request-TenantName"></a>
The name of the tenant through which this bulk email will be sent.  
 The email sending operation will only succeed if all referenced resources (identities, configuration sets, and templates) are associated with this tenant. 
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

## Response Syntax
<a name="API_SendBulkEmail_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BulkEmailEntryResults": [ 
      { 
         "Error": "string",
         "MessageId": "string",
         "Status": "string"
      }
   ]
}
```

## Response Elements
<a name="API_SendBulkEmail_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [BulkEmailEntryResults](#API_SendBulkEmail_ResponseSyntax) **   <a name="SES-SendBulkEmail-response-BulkEmailEntryResults"></a>
One object per intended recipient. Check each response object and retry any messages with a failure status.  
Type: Array of [BulkEmailEntryResult](API_BulkEmailEntryResult.md) objects

## Errors
<a name="API_SendBulkEmail_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccountSuspendedException **   
The message can't be sent because the account's ability to send email has been permanently restricted.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** MailFromDomainNotVerifiedException **   
The message can't be sent because the sending domain isn't verified.  
HTTP Status Code: 400

 ** MessageRejected **   
The message can't be sent because it contains invalid content.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** SendingPausedException **   
The message can't be sent because the account's ability to send email is currently paused.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_SendBulkEmail_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/SendBulkEmail) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/SendBulkEmail) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SendBulkEmail) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/SendBulkEmail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SendBulkEmail) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/SendBulkEmail) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/SendBulkEmail) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/SendBulkEmail) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/SendBulkEmail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SendBulkEmail) 

# SendCustomVerificationEmail
<a name="API_SendCustomVerificationEmail"></a>

Adds an email address to the list of identities for your Amazon SES account in the current AWS Region and attempts to verify it. As a result of executing this operation, a customized verification email is sent to the specified address.

To use this operation, you must first create a custom verification email template. For more information about creating and using custom verification email templates, see [Using custom verification email templates](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) in the *Amazon SES Developer Guide*.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_SendCustomVerificationEmail_RequestSyntax"></a>

```
POST /v2/email/outbound-custom-verification-emails HTTP/1.1
Content-type: application/json

{
   "ConfigurationSetName": "string",
   "EmailAddress": "string",
   "TemplateName": "string"
}
```

## URI Request Parameters
<a name="API_SendCustomVerificationEmail_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_SendCustomVerificationEmail_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ConfigurationSetName](#API_SendCustomVerificationEmail_RequestSyntax) **   <a name="SES-SendCustomVerificationEmail-request-ConfigurationSetName"></a>
Name of a configuration set to use when sending the verification email.  
Type: String  
Required: No

 ** [EmailAddress](#API_SendCustomVerificationEmail_RequestSyntax) **   <a name="SES-SendCustomVerificationEmail-request-EmailAddress"></a>
The email address to verify.  
Type: String  
Required: Yes

 ** [TemplateName](#API_SendCustomVerificationEmail_RequestSyntax) **   <a name="SES-SendCustomVerificationEmail-request-TemplateName"></a>
The name of the custom verification email template to use when sending the verification email.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_SendCustomVerificationEmail_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "MessageId": "string"
}
```

## Response Elements
<a name="API_SendCustomVerificationEmail_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [MessageId](#API_SendCustomVerificationEmail_ResponseSyntax) **   <a name="SES-SendCustomVerificationEmail-response-MessageId"></a>
The unique message identifier returned from the `SendCustomVerificationEmail` operation.  
Type: String

## Errors
<a name="API_SendCustomVerificationEmail_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** MailFromDomainNotVerifiedException **   
The message can't be sent because the sending domain isn't verified.  
HTTP Status Code: 400

 ** MessageRejected **   
The message can't be sent because it contains invalid content.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** SendingPausedException **   
The message can't be sent because the account's ability to send email is currently paused.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_SendCustomVerificationEmail_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/SendCustomVerificationEmail) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/SendCustomVerificationEmail) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SendCustomVerificationEmail) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/SendCustomVerificationEmail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SendCustomVerificationEmail) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/SendCustomVerificationEmail) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/SendCustomVerificationEmail) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/SendCustomVerificationEmail) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/SendCustomVerificationEmail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SendCustomVerificationEmail) 

# SendEmail
<a name="API_SendEmail"></a>

Sends an email message. You can use the Amazon SES API v2 to send the following types of messages:
+  **Simple** – A standard email message. When you create this type of message, you specify the sender, the recipient, and the message body, and Amazon SES assembles the message for you.
+  **Raw** – A raw, MIME-formatted email message. When you send this type of email, you have to specify all of the message headers, as well as the message body. You can use this message type to send messages that contain attachments. The message that you specify has to be a valid MIME message.
+  **Templated** – A message that contains personalization tags. When you send this type of email, Amazon SES API v2 automatically replaces the tags with values that you specify.

## Request Syntax
<a name="API_SendEmail_RequestSyntax"></a>

```
POST /v2/email/outbound-emails HTTP/1.1
Content-type: application/json

{
   "ConfigurationSetName": "string",
   "Content": { 
      "Raw": { 
         "Data": blob
      },
      "Simple": { 
         "Attachments": [ 
            { 
               "ContentDescription": "string",
               "ContentDisposition": "string",
               "ContentId": "string",
               "ContentTransferEncoding": "string",
               "ContentType": "string",
               "FileName": "string",
               "RawContent": blob
            }
         ],
         "Body": { 
            "Html": { 
               "Charset": "string",
               "Data": "string"
            },
            "Text": { 
               "Charset": "string",
               "Data": "string"
            }
         },
         "Headers": [ 
            { 
               "Name": "string",
               "Value": "string"
            }
         ],
         "Subject": { 
            "Charset": "string",
            "Data": "string"
         }
      },
      "Template": { 
         "Attachments": [ 
            { 
               "ContentDescription": "string",
               "ContentDisposition": "string",
               "ContentId": "string",
               "ContentTransferEncoding": "string",
               "ContentType": "string",
               "FileName": "string",
               "RawContent": blob
            }
         ],
         "Headers": [ 
            { 
               "Name": "string",
               "Value": "string"
            }
         ],
         "TemplateArn": "string",
         "TemplateContent": { 
            "Html": "string",
            "Subject": "string",
            "Text": "string"
         },
         "TemplateData": "string",
         "TemplateName": "string"
      }
   },
   "Destination": { 
      "BccAddresses": [ "string" ],
      "CcAddresses": [ "string" ],
      "ToAddresses": [ "string" ]
   },
   "EmailTags": [ 
      { 
         "Name": "string",
         "Value": "string"
      }
   ],
   "EndpointId": "string",
   "FeedbackForwardingEmailAddress": "string",
   "FeedbackForwardingEmailAddressIdentityArn": "string",
   "FromEmailAddress": "string",
   "FromEmailAddressIdentityArn": "string",
   "ListManagementOptions": { 
      "ContactListName": "string",
      "TopicName": "string"
   },
   "ReplyToAddresses": [ "string" ],
   "TenantName": "string"
}
```

## URI Request Parameters
<a name="API_SendEmail_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_SendEmail_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ConfigurationSetName](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-ConfigurationSetName"></a>
The name of the configuration set to use when sending the email.  
Type: String  
Required: No

 ** [Content](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-Content"></a>
An object that contains the body of the message. You can send either a Simple message, Raw message, or a Templated message.  
Type: [EmailContent](API_EmailContent.md) object  
Required: Yes

 ** [Destination](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-Destination"></a>
An object that contains the recipients of the email message.  
Type: [Destination](API_Destination.md) object  
Required: No

 ** [EmailTags](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-EmailTags"></a>
A list of tags, in the form of name/value pairs, to apply to an email that you send using the `SendEmail` operation. Tags correspond to characteristics of the email that you define, so that you can publish email sending events.   
Type: Array of [MessageTag](API_MessageTag.md) objects  
Required: No

 ** [EndpointId](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-EndpointId"></a>
The ID of the multi-region endpoint (global-endpoint).  
Type: String  
Required: No

 ** [FeedbackForwardingEmailAddress](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-FeedbackForwardingEmailAddress"></a>
The address that you want bounce and complaint notifications to be sent to.  
Type: String  
Required: No

 ** [FeedbackForwardingEmailAddressIdentityArn](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-FeedbackForwardingEmailAddressIdentityArn"></a>
This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the `FeedbackForwardingEmailAddress` parameter.  
For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use feedback@example.com, then you would specify the `FeedbackForwardingEmailAddressIdentityArn` to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the `FeedbackForwardingEmailAddress` to be feedback@example.com.  
For more information about sending authorization, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html).  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** [FromEmailAddress](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-FromEmailAddress"></a>
The email address to use as the "From" address for the email. The address that you specify has to be verified.   
Type: String  
Required: No

 ** [FromEmailAddressIdentityArn](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-FromEmailAddressIdentityArn"></a>
This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the `FromEmailAddress` parameter.  
For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use sender@example.com, then you would specify the `FromEmailAddressIdentityArn` to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the `FromEmailAddress` to be sender@example.com.  
For more information about sending authorization, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html).  
For Raw emails, the `FromEmailAddressIdentityArn` value overrides the X-SES-SOURCE-ARN and X-SES-FROM-ARN headers specified in raw email message content.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** [ListManagementOptions](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-ListManagementOptions"></a>
An object used to specify a list or topic to which an email belongs, which will be used when a contact chooses to unsubscribe.  
Type: [ListManagementOptions](API_ListManagementOptions.md) object  
Required: No

 ** [ReplyToAddresses](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-ReplyToAddresses"></a>
The "Reply-to" email addresses for the message. When the recipient replies to the message, each Reply-to address receives the reply.  
Type: Array of strings  
Required: No

 ** [TenantName](#API_SendEmail_RequestSyntax) **   <a name="SES-SendEmail-request-TenantName"></a>
The name of the tenant through which this email will be sent.  
The email sending operation will only succeed if all referenced resources (identities, configuration sets, and templates) are associated with this tenant. 
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

## Response Syntax
<a name="API_SendEmail_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "MessageId": "string"
}
```

## Response Elements
<a name="API_SendEmail_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [MessageId](#API_SendEmail_ResponseSyntax) **   <a name="SES-SendEmail-response-MessageId"></a>
A unique identifier for the message that is generated when the message is accepted.  
It's possible for Amazon SES to accept a message without sending it. For example, this can happen when the message that you're trying to send has an attachment that contains a virus, or when you send a templated email that contains invalid personalization content.
Type: String

## Errors
<a name="API_SendEmail_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccountSuspendedException **   
The message can't be sent because the account's ability to send email has been permanently restricted.  
HTTP Status Code: 400

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** LimitExceededException **   
There are too many instances of the specified resource type.  
HTTP Status Code: 400

 ** MailFromDomainNotVerifiedException **   
The message can't be sent because the sending domain isn't verified.  
HTTP Status Code: 400

 ** MessageRejected **   
The message can't be sent because it contains invalid content.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** SendingPausedException **   
The message can't be sent because the account's ability to send email is currently paused.  
HTTP Status Code: 400

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_SendEmail_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/SendEmail) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/SendEmail) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SendEmail) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/SendEmail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SendEmail) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/SendEmail) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/SendEmail) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/SendEmail) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/SendEmail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SendEmail) 

# TagResource
<a name="API_TagResource"></a>

Add one or more tags (keys and values) to a specified resource. A *tag* is a label that you optionally define and associate with a resource. Tags can help you categorize and manage resources in different ways, such as by purpose, owner, environment, or other criteria. A resource can have as many as 50 tags.

Each tag consists of a required *tag key* and an associated *tag value*, both of which you define. A tag key is a general label that acts as a category for more specific tag values. A tag value acts as a descriptor within a tag key.

## Request Syntax
<a name="API_TagResource_RequestSyntax"></a>

```
POST /v2/email/tags HTTP/1.1
Content-type: application/json

{
   "ResourceArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_TagResource_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_TagResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ResourceArn](#API_TagResource_RequestSyntax) **   <a name="SES-TagResource-request-ResourceArn"></a>
The Amazon Resource Name (ARN) of the resource that you want to add one or more tags to.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="SES-TagResource-request-Tags"></a>
A list of the tags that you want to add to the resource. A tag consists of a required tag key (`Key`) and an associated tag value (`Value`). The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.  
Type: Array of [Tag](API_Tag.md) objects  
Required: Yes

## Response Syntax
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_TagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_TagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_TagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/TagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/TagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/TagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/TagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/TagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/TagResource) 

# TestRenderEmailTemplate
<a name="API_TestRenderEmailTemplate"></a>

Creates a preview of the MIME content of an email when provided with a template and a set of replacement data.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_TestRenderEmailTemplate_RequestSyntax"></a>

```
POST /v2/email/templates/TemplateName/render HTTP/1.1
Content-type: application/json

{
   "TemplateData": "string"
}
```

## URI Request Parameters
<a name="API_TestRenderEmailTemplate_RequestParameters"></a>

The request uses the following URI parameters.

 ** [TemplateName](#API_TestRenderEmailTemplate_RequestSyntax) **   <a name="SES-TestRenderEmailTemplate-request-uri-TemplateName"></a>
The name of the template.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_TestRenderEmailTemplate_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [TemplateData](#API_TestRenderEmailTemplate_RequestSyntax) **   <a name="SES-TestRenderEmailTemplate-request-TemplateData"></a>
A list of replacement values to apply to the template. This parameter is a JSON object, typically consisting of key-value pairs in which the keys correspond to replacement tags in the email template.  
Type: String  
Length Constraints: Maximum length of 262144.  
Required: Yes

## Response Syntax
<a name="API_TestRenderEmailTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "RenderedTemplate": "string"
}
```

## Response Elements
<a name="API_TestRenderEmailTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [RenderedTemplate](#API_TestRenderEmailTemplate_ResponseSyntax) **   <a name="SES-TestRenderEmailTemplate-response-RenderedTemplate"></a>
The complete MIME message rendered by applying the data in the `TemplateData` parameter to the template specified in the TemplateName parameter.  
Type: String

## Errors
<a name="API_TestRenderEmailTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_TestRenderEmailTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/TestRenderEmailTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/TestRenderEmailTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/TestRenderEmailTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/TestRenderEmailTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/TestRenderEmailTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/TestRenderEmailTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/TestRenderEmailTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/TestRenderEmailTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/TestRenderEmailTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/TestRenderEmailTemplate) 

# UntagResource
<a name="API_UntagResource"></a>

Remove one or more tags (keys and values) from a specified resource.

## Request Syntax
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /v2/email/tags?ResourceArn=ResourceArn&TagKeys=TagKeys HTTP/1.1
```

## URI Request Parameters
<a name="API_UntagResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ResourceArn](#API_UntagResource_RequestSyntax) **   <a name="SES-UntagResource-request-uri-ResourceArn"></a>
The Amazon Resource Name (ARN) of the resource that you want to remove one or more tags from.  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="SES-UntagResource-request-uri-TagKeys"></a>
The tags (tag keys) that you want to remove from the resource. When you specify a tag key, the action removes both that key and its associated tag value.  
To remove more than one tag from the resource, append the `TagKeys` parameter and argument for each additional tag to remove, separated by an ampersand. For example: `/v2/email/tags?ResourceArn=ResourceArn&TagKeys=Key1&TagKeys=Key2`   
Required: Yes

## Request Body
<a name="API_UntagResource_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UntagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UntagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_UntagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/UntagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/UntagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/UntagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/UntagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/UntagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/UntagResource) 

# UpdateConfigurationSetEventDestination
<a name="API_UpdateConfigurationSetEventDestination"></a>

Update the configuration of an event destination for a configuration set.

 *Events* include message sends, deliveries, opens, clicks, bounces, and complaints. *Event destinations* are places that you can send information about these events to. For example, you can send event data to Amazon EventBridge and associate a rule to send the event to the specified target.

## Request Syntax
<a name="API_UpdateConfigurationSetEventDestination_RequestSyntax"></a>

```
PUT /v2/email/configuration-sets/ConfigurationSetName/event-destinations/EventDestinationName HTTP/1.1
Content-type: application/json

{
   "EventDestination": { 
      "CloudWatchDestination": { 
         "DimensionConfigurations": [ 
            { 
               "DefaultDimensionValue": "string",
               "DimensionName": "string",
               "DimensionValueSource": "string"
            }
         ]
      },
      "Enabled": boolean,
      "EventBridgeDestination": { 
         "EventBusArn": "string"
      },
      "KinesisFirehoseDestination": { 
         "DeliveryStreamArn": "string",
         "IamRoleArn": "string"
      },
      "MatchingEventTypes": [ "string" ],
      "PinpointDestination": { 
         "ApplicationArn": "string"
      },
      "SnsDestination": { 
         "TopicArn": "string"
      }
   }
}
```

## URI Request Parameters
<a name="API_UpdateConfigurationSetEventDestination_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ConfigurationSetName](#API_UpdateConfigurationSetEventDestination_RequestSyntax) **   <a name="SES-UpdateConfigurationSetEventDestination-request-uri-ConfigurationSetName"></a>
The name of the configuration set that contains the event destination to modify.  
Required: Yes

 ** [EventDestinationName](#API_UpdateConfigurationSetEventDestination_RequestSyntax) **   <a name="SES-UpdateConfigurationSetEventDestination-request-uri-EventDestinationName"></a>
The name of the event destination.  
Required: Yes

## Request Body
<a name="API_UpdateConfigurationSetEventDestination_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [EventDestination](#API_UpdateConfigurationSetEventDestination_RequestSyntax) **   <a name="SES-UpdateConfigurationSetEventDestination-request-EventDestination"></a>
An object that defines the event destination.  
Type: [EventDestinationDefinition](API_EventDestinationDefinition.md) object  
Required: Yes

## Response Syntax
<a name="API_UpdateConfigurationSetEventDestination_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UpdateConfigurationSetEventDestination_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UpdateConfigurationSetEventDestination_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_UpdateConfigurationSetEventDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/UpdateConfigurationSetEventDestination) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/UpdateConfigurationSetEventDestination) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/UpdateConfigurationSetEventDestination) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/UpdateConfigurationSetEventDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/UpdateConfigurationSetEventDestination) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/UpdateConfigurationSetEventDestination) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/UpdateConfigurationSetEventDestination) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/UpdateConfigurationSetEventDestination) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/UpdateConfigurationSetEventDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/UpdateConfigurationSetEventDestination) 

# UpdateContact
<a name="API_UpdateContact"></a>

Updates a contact's preferences for a list.

**Note**  
You must specify all existing topic preferences in the `TopicPreferences` object, not just the ones that need updating; otherwise, all your existing preferences will be removed.

## Request Syntax
<a name="API_UpdateContact_RequestSyntax"></a>

```
PUT /v2/email/contact-lists/ContactListName/contacts/EmailAddress HTTP/1.1
Content-type: application/json

{
   "AttributesData": "string",
   "TopicPreferences": [ 
      { 
         "SubscriptionStatus": "string",
         "TopicName": "string"
      }
   ],
   "UnsubscribeAll": boolean
}
```

## URI Request Parameters
<a name="API_UpdateContact_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ContactListName](#API_UpdateContact_RequestSyntax) **   <a name="SES-UpdateContact-request-uri-ContactListName"></a>
The name of the contact list.  
Required: Yes

 ** [EmailAddress](#API_UpdateContact_RequestSyntax) **   <a name="SES-UpdateContact-request-uri-EmailAddress"></a>
The contact's email address.  
Required: Yes

## Request Body
<a name="API_UpdateContact_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AttributesData](#API_UpdateContact_RequestSyntax) **   <a name="SES-UpdateContact-request-AttributesData"></a>
The attribute data attached to a contact.  
Type: String  
Required: No

 ** [TopicPreferences](#API_UpdateContact_RequestSyntax) **   <a name="SES-UpdateContact-request-TopicPreferences"></a>
The contact's preference for being opted-in to or opted-out of a topic.  
Type: Array of [TopicPreference](API_TopicPreference.md) objects  
Required: No

 ** [UnsubscribeAll](#API_UpdateContact_RequestSyntax) **   <a name="SES-UpdateContact-request-UnsubscribeAll"></a>
A boolean value status noting if the contact is unsubscribed from all contact list topics.  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_UpdateContact_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UpdateContact_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UpdateContact_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_UpdateContact_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/UpdateContact) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/UpdateContact) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/UpdateContact) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/UpdateContact) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/UpdateContact) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/UpdateContact) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/UpdateContact) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/UpdateContact) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/UpdateContact) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/UpdateContact) 

# UpdateContactList
<a name="API_UpdateContactList"></a>

Updates contact list metadata. This operation does a complete replacement.

## Request Syntax
<a name="API_UpdateContactList_RequestSyntax"></a>

```
PUT /v2/email/contact-lists/ContactListName HTTP/1.1
Content-type: application/json

{
   "Description": "string",
   "Topics": [ 
      { 
         "DefaultSubscriptionStatus": "string",
         "Description": "string",
         "DisplayName": "string",
         "TopicName": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_UpdateContactList_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ContactListName](#API_UpdateContactList_RequestSyntax) **   <a name="SES-UpdateContactList-request-uri-ContactListName"></a>
The name of the contact list.  
Required: Yes

## Request Body
<a name="API_UpdateContactList_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Description](#API_UpdateContactList_RequestSyntax) **   <a name="SES-UpdateContactList-request-Description"></a>
A description of what the contact list is about.  
Type: String  
Required: No

 ** [Topics](#API_UpdateContactList_RequestSyntax) **   <a name="SES-UpdateContactList-request-Topics"></a>
An interest group, theme, or label within a list. A contact list can have multiple topics.  
Type: Array of [Topic](API_Topic.md) objects  
Required: No

## Response Syntax
<a name="API_UpdateContactList_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UpdateContactList_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UpdateContactList_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConcurrentModificationException **   
The resource is being modified by another operation or thread.  
HTTP Status Code: 500

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_UpdateContactList_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/UpdateContactList) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/UpdateContactList) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/UpdateContactList) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/UpdateContactList) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/UpdateContactList) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/UpdateContactList) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/UpdateContactList) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/UpdateContactList) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/UpdateContactList) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/UpdateContactList) 

# UpdateCustomVerificationEmailTemplate
<a name="API_UpdateCustomVerificationEmailTemplate"></a>

Updates an existing custom verification email template.

For more information about custom verification email templates, see [Using custom verification email templates](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) in the *Amazon SES Developer Guide*.

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_UpdateCustomVerificationEmailTemplate_RequestSyntax"></a>

```
PUT /v2/email/custom-verification-email-templates/TemplateName HTTP/1.1
Content-type: application/json

{
   "FailureRedirectionURL": "string",
   "FromEmailAddress": "string",
   "SuccessRedirectionURL": "string",
   "TemplateContent": "string",
   "TemplateSubject": "string"
}
```

## URI Request Parameters
<a name="API_UpdateCustomVerificationEmailTemplate_RequestParameters"></a>

The request uses the following URI parameters.

 ** [TemplateName](#API_UpdateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-UpdateCustomVerificationEmailTemplate-request-uri-TemplateName"></a>
The name of the custom verification email template that you want to update.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_UpdateCustomVerificationEmailTemplate_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [FailureRedirectionURL](#API_UpdateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-UpdateCustomVerificationEmailTemplate-request-FailureRedirectionURL"></a>
The URL that the recipient of the verification email is sent to if his or her address is not successfully verified.  
Type: String  
Required: Yes

 ** [FromEmailAddress](#API_UpdateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-UpdateCustomVerificationEmailTemplate-request-FromEmailAddress"></a>
The email address that the custom verification email is sent from.  
Type: String  
Required: Yes

 ** [SuccessRedirectionURL](#API_UpdateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-UpdateCustomVerificationEmailTemplate-request-SuccessRedirectionURL"></a>
The URL that the recipient of the verification email is sent to if his or her address is successfully verified.  
Type: String  
Required: Yes

 ** [TemplateContent](#API_UpdateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-UpdateCustomVerificationEmailTemplate-request-TemplateContent"></a>
The content of the custom verification email. The total size of the email must be less than 10 MB. The message body may contain HTML, with some limitations. For more information, see [Custom verification email frequently asked questions](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom-faq) in the *Amazon SES Developer Guide*.  
Type: String  
Required: Yes

 ** [TemplateSubject](#API_UpdateCustomVerificationEmailTemplate_RequestSyntax) **   <a name="SES-UpdateCustomVerificationEmailTemplate-request-TemplateSubject"></a>
The subject line of the custom verification email.  
Type: String  
Required: Yes

## Response Syntax
<a name="API_UpdateCustomVerificationEmailTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UpdateCustomVerificationEmailTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UpdateCustomVerificationEmailTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_UpdateCustomVerificationEmailTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/UpdateCustomVerificationEmailTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/UpdateCustomVerificationEmailTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/UpdateCustomVerificationEmailTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/UpdateCustomVerificationEmailTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/UpdateCustomVerificationEmailTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/UpdateCustomVerificationEmailTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/UpdateCustomVerificationEmailTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/UpdateCustomVerificationEmailTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/UpdateCustomVerificationEmailTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/UpdateCustomVerificationEmailTemplate) 

# UpdateEmailIdentityPolicy
<a name="API_UpdateEmailIdentityPolicy"></a>

Updates the specified sending authorization policy for the given identity (an email address or a domain). This API returns successfully even if a policy with the specified name does not exist.

**Note**  
This API is for the identity owner only. If you have not verified the identity, this API will return an error.

Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html).

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_UpdateEmailIdentityPolicy_RequestSyntax"></a>

```
PUT /v2/email/identities/EmailIdentity/policies/PolicyName HTTP/1.1
Content-type: application/json

{
   "Policy": "string"
}
```

## URI Request Parameters
<a name="API_UpdateEmailIdentityPolicy_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EmailIdentity](#API_UpdateEmailIdentityPolicy_RequestSyntax) **   <a name="SES-UpdateEmailIdentityPolicy-request-uri-EmailIdentity"></a>
The email identity.  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [PolicyName](#API_UpdateEmailIdentityPolicy_RequestSyntax) **   <a name="SES-UpdateEmailIdentityPolicy-request-uri-PolicyName"></a>
The name of the policy.  
The policy name cannot exceed 64 characters and can only include alphanumeric characters, dashes, and underscores.  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Required: Yes

## Request Body
<a name="API_UpdateEmailIdentityPolicy_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Policy](#API_UpdateEmailIdentityPolicy_RequestSyntax) **   <a name="SES-UpdateEmailIdentityPolicy-request-Policy"></a>
The text of the policy in JSON format. The policy cannot exceed 4 KB.  
 For information about the syntax of sending authorization policies, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization-policies.html).  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_UpdateEmailIdentityPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UpdateEmailIdentityPolicy_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UpdateEmailIdentityPolicy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_UpdateEmailIdentityPolicy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/UpdateEmailIdentityPolicy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/UpdateEmailIdentityPolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/UpdateEmailIdentityPolicy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/UpdateEmailIdentityPolicy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/UpdateEmailIdentityPolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/UpdateEmailIdentityPolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/UpdateEmailIdentityPolicy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/UpdateEmailIdentityPolicy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/UpdateEmailIdentityPolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/UpdateEmailIdentityPolicy) 

# UpdateEmailTemplate
<a name="API_UpdateEmailTemplate"></a>

Updates an email template. Email templates enable you to send personalized email to one or more destinations in a single API operation. For more information, see the [Amazon SES Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-personalized-email-api.html).

You can execute this operation no more than once per second.

## Request Syntax
<a name="API_UpdateEmailTemplate_RequestSyntax"></a>

```
PUT /v2/email/templates/TemplateName HTTP/1.1
Content-type: application/json

{
   "TemplateContent": { 
      "Html": "string",
      "Subject": "string",
      "Text": "string"
   }
}
```

## URI Request Parameters
<a name="API_UpdateEmailTemplate_RequestParameters"></a>

The request uses the following URI parameters.

 ** [TemplateName](#API_UpdateEmailTemplate_RequestSyntax) **   <a name="SES-UpdateEmailTemplate-request-uri-TemplateName"></a>
The name of the template.  
Length Constraints: Minimum length of 1.  
Required: Yes

## Request Body
<a name="API_UpdateEmailTemplate_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [TemplateContent](#API_UpdateEmailTemplate_RequestSyntax) **   <a name="SES-UpdateEmailTemplate-request-TemplateContent"></a>
The content of the email template, composed of a subject line, an HTML part, and a text-only part.  
Type: [EmailTemplateContent](API_EmailTemplateContent.md) object  
Required: Yes

## Response Syntax
<a name="API_UpdateEmailTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UpdateEmailTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UpdateEmailTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** NotFoundException **   
The resource you attempted to access doesn't exist.  
HTTP Status Code: 404

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_UpdateEmailTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/UpdateEmailTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/UpdateEmailTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/UpdateEmailTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/UpdateEmailTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/UpdateEmailTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/UpdateEmailTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/UpdateEmailTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/UpdateEmailTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/UpdateEmailTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/UpdateEmailTemplate) 

# UpdateReputationEntityCustomerManagedStatus
<a name="API_UpdateReputationEntityCustomerManagedStatus"></a>

Update the customer-managed sending status for a reputation entity. This allows you to enable, disable, or reinstate sending for the entity.

The customer-managed status works in conjunction with the AWS Amazon SES-managed status to determine the overall sending capability. When you update the customer-managed status, the AWS Amazon SES-managed status remains unchanged. If AWS Amazon SES has disabled the entity, it will not be allowed to send regardless of the customer-managed status setting. When you reinstate an entity through the customer-managed status, it can continue sending only if the AWS Amazon SES-managed status also permits sending, even if there are active reputation findings, until the findings are resolved or new violations occur.

## Request Syntax
<a name="API_UpdateReputationEntityCustomerManagedStatus_RequestSyntax"></a>

```
PUT /v2/email/reputation/entities/ReputationEntityType/ReputationEntityReference/customer-managed-status HTTP/1.1
Content-type: application/json

{
   "SendingStatus": "string"
}
```

## URI Request Parameters
<a name="API_UpdateReputationEntityCustomerManagedStatus_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ReputationEntityReference](#API_UpdateReputationEntityCustomerManagedStatus_RequestSyntax) **   <a name="SES-UpdateReputationEntityCustomerManagedStatus-request-uri-ReputationEntityReference"></a>
The unique identifier for the reputation entity. For resource-type entities, this is the Amazon Resource Name (ARN) of the resource.  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [ReputationEntityType](#API_UpdateReputationEntityCustomerManagedStatus_RequestSyntax) **   <a name="SES-UpdateReputationEntityCustomerManagedStatus-request-uri-ReputationEntityType"></a>
The type of reputation entity. Currently, only `RESOURCE` type entities are supported.  
Valid Values: `RESOURCE`   
Required: Yes

## Request Body
<a name="API_UpdateReputationEntityCustomerManagedStatus_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [SendingStatus](#API_UpdateReputationEntityCustomerManagedStatus_RequestSyntax) **   <a name="SES-UpdateReputationEntityCustomerManagedStatus-request-SendingStatus"></a>
The new customer-managed sending status for the reputation entity. This can be one of the following:  
+  `ENABLED` – Allow sending for this entity.
+  `DISABLED` – Prevent sending for this entity.
+  `REINSTATED` – Allow sending even if there are active reputation findings.
Type: String  
Valid Values: `ENABLED | REINSTATED | DISABLED`   
Required: Yes

## Response Syntax
<a name="API_UpdateReputationEntityCustomerManagedStatus_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UpdateReputationEntityCustomerManagedStatus_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UpdateReputationEntityCustomerManagedStatus_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConflictException **   
If there is already an ongoing account details update under review.  
HTTP Status Code: 409

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_UpdateReputationEntityCustomerManagedStatus_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/UpdateReputationEntityCustomerManagedStatus) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/UpdateReputationEntityCustomerManagedStatus) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/UpdateReputationEntityCustomerManagedStatus) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/UpdateReputationEntityCustomerManagedStatus) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/UpdateReputationEntityCustomerManagedStatus) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/UpdateReputationEntityCustomerManagedStatus) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/UpdateReputationEntityCustomerManagedStatus) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/UpdateReputationEntityCustomerManagedStatus) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/UpdateReputationEntityCustomerManagedStatus) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/UpdateReputationEntityCustomerManagedStatus) 

# UpdateReputationEntityPolicy
<a name="API_UpdateReputationEntityPolicy"></a>

Update the reputation management policy for a reputation entity. The policy determines how the entity responds to reputation findings, such as automatically pausing sending when certain thresholds are exceeded.

Reputation management policies are AWS Amazon SES-managed (predefined policies). You can select from none, standard, and strict policies.

## Request Syntax
<a name="API_UpdateReputationEntityPolicy_RequestSyntax"></a>

```
PUT /v2/email/reputation/entities/ReputationEntityType/ReputationEntityReference/policy HTTP/1.1
Content-type: application/json

{
   "ReputationEntityPolicy": "string"
}
```

## URI Request Parameters
<a name="API_UpdateReputationEntityPolicy_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ReputationEntityReference](#API_UpdateReputationEntityPolicy_RequestSyntax) **   <a name="SES-UpdateReputationEntityPolicy-request-uri-ReputationEntityReference"></a>
The unique identifier for the reputation entity. For resource-type entities, this is the Amazon Resource Name (ARN) of the resource.  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** [ReputationEntityType](#API_UpdateReputationEntityPolicy_RequestSyntax) **   <a name="SES-UpdateReputationEntityPolicy-request-uri-ReputationEntityType"></a>
The type of reputation entity. Currently, only `RESOURCE` type entities are supported.  
Valid Values: `RESOURCE`   
Required: Yes

## Request Body
<a name="API_UpdateReputationEntityPolicy_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ReputationEntityPolicy](#API_UpdateReputationEntityPolicy_RequestSyntax) **   <a name="SES-UpdateReputationEntityPolicy-request-ReputationEntityPolicy"></a>
The Amazon Resource Name (ARN) of the reputation management policy to apply to this entity. This is an AWS Amazon SES-managed policy.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## Response Syntax
<a name="API_UpdateReputationEntityPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UpdateReputationEntityPolicy_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UpdateReputationEntityPolicy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
The input you provided is invalid.  
HTTP Status Code: 400

 ** ConflictException **   
If there is already an ongoing account details update under review.  
HTTP Status Code: 409

 ** TooManyRequestsException **   
Too many requests have been made to the operation.  
HTTP Status Code: 429

## See Also
<a name="API_UpdateReputationEntityPolicy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/sesv2-2019-09-27/UpdateReputationEntityPolicy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/sesv2-2019-09-27/UpdateReputationEntityPolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/UpdateReputationEntityPolicy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/sesv2-2019-09-27/UpdateReputationEntityPolicy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/UpdateReputationEntityPolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/sesv2-2019-09-27/UpdateReputationEntityPolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/sesv2-2019-09-27/UpdateReputationEntityPolicy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/sesv2-2019-09-27/UpdateReputationEntityPolicy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/UpdateReputationEntityPolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/UpdateReputationEntityPolicy)