# 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 Amazon Pinpoint 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 /v1/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="pinpoint-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 Amazon Pinpoint 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="pinpoint-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/pinpoint-email-2018-07-26/PutDedicatedIpInPool) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/pinpoint-email-2018-07-26/PutDedicatedIpInPool) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/pinpoint-email-2018-07-26/PutDedicatedIpInPool) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/pinpoint-email-2018-07-26/PutDedicatedIpInPool) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/pinpoint-email-2018-07-26/PutDedicatedIpInPool) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/pinpoint-email-2018-07-26/PutDedicatedIpInPool) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/pinpoint-email-2018-07-26/PutDedicatedIpInPool) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/pinpoint-email-2018-07-26/PutDedicatedIpInPool) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/pinpoint-email-2018-07-26/PutDedicatedIpInPool) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/pinpoint-email-2018-07-26/PutDedicatedIpInPool)