CreateDedicatedIpPool method

Written by

Updated at October 14, 2026

Creates a pool of dedicated IP addresses in a folder. The folder is selected based on the service account the request originates from.

Request

POST /v2/email/dedicated-ip-pools HTTP/2

{
  "PoolName": "<pool_name>",
  "ScalingMode": "STANDARD",
  "Tags": [
    {
      "Key": "<label_key>",
      "Value": "<label_value>"
    }
  ]
}

Parameter	Description
`PoolName`	Type: String. Pool name. It must be unique within the cloud. The allowed characters are lowercase Latin letters, digits, underscores (`_`), and hyphens (`-`). The name must be 1 to 64 characters long. You cannot use names reserved by the service.
`ScalingMode`	Type: String. Pool scaling mode. The possible value is `STANDARD`. This is an optional parameter.
`Tags`	Type: Array. Pool label array. This is an optional parameter.
`Key`	Type: String. Label key.
`Value`	Type: String. Label value.

A successful request returns 200 OK in the response.

For all errors, the response body has the same format:

{
   "Code": "<error_name>",
   "message": "<error_description>"
}

The name of the error is taken from its code, e.g., BadRequestException.

The possible errors include:

Error code	Description
`400 BadRequestException`	The request contains invalid headers or parameters. You also get this error if the pool name does not meet the requirements, a reserved pool name is specified, or `ScalingMode` is not equal to `STANDARD`.
`409 AlreadyExistsException`	A pool with this name already exists. Choose a different one.
`429 TooManyRequestsException`	The request quota was exceeded.