# Dynamic IP Pools

Dynamic IP Pools allow you to group your dedicated IPs into customized "pools" based on sender reputation. Domains enrolled in Dynamic IP Pools will be assigned to a pool based on the result of periodic health checks.

## Enroll domain

 - [POST /v3/domains/{name}/dynamic_pools](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/post-v3-domains--name--dynamic-pools.md): Domains enrolled in the Dynamic IP pools feature will be assigned an IP pool based on reputation.
The feature must be enabled and configured before enrolling domains.

## Remove domain from dynamic IP pools

 - [DELETE /v3/domains/{name}/dynamic_pools](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/delete-v3-domains--name--dynamic-pools.md): The behavior of this endpoint depends on the value of the  and  parameters.
One of these parameters (but not both) must be provided. If  is provided, the IP(s) will be assigned to the domain.
 can include one of the following:
 * valid IP(s): this IP address or addresses will be added to the domain
 * string : if the account is eligible for shared IPs, a suitable shared IP will be chosen and added to the domain
The 'replacement_ip' parameter cannot include any IPs that are already assigned to a Dedicated IP Pool or a Dynamic IP Pool.
If  is provided, the Dedicated IP Pool will be assigned to the domain.

## List assignable domains

 - [GET /v3/domains/dynamic_pools/assignable](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/get-v3-domains-dynamic-pools-assignable.md): Lists all domains that are not already enrolled in dynamic IP pools.

## Enroll all account domains

 - [POST /v3/domains/all/dynamic_pools/enroll](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/post-v3-domains-all-dynamic-pools-enroll.md): Begins an asynchronous background job to assign all domains to Dynamic IP Pools.
This can also include domains belonging to subaccounts depending on the provided parameters.
The Dynamic IP Pools feature must be enabled for the account and the request must come from a parent account user.

## List all Dynamic IP pools

 - [GET /v3/dynamic_pools](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/get-v3-dynamic-pools.md): Returns the list of IPs belonging to each of the account's Dynamic IP Pools.

## Initialize/set IPs for all pools

 - [POST /v3/dynamic_pools/all](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/post-v3-dynamic-pools-all.md): Any existing IPs in dynamic IP pools will be replaced. All IPs must be dedicated IPs and
belong to the account. Additionally, each dynamic IP pool must contain at least 1 IP that
is not currently warming.

## Remove all dynamic IP pools

 - [DELETE /v3/dynamic_pools/all](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/delete-v3-dynamic-pools-all.md): Removes all dynamic IP pools from the account. All domains on the account (and subaccounts, if any) must be removed from dynamic IP pools before the pools can be removed. Any standard dedicated IP pools will not be modified.

## Add IP to Dynamic IP Pool

 - [POST /v3/dynamic_pools/{pool_name}/{ip}](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/post-v3-dynamic-pools--pool-name---ip-.md): Adds a given IP to a Dynamic IP Pool. The IP must be dedicated and belong to the account.

## Update pool IPs

 - [PATCH /v3/dynamic_pools/{pool_name}](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/patch-v3-dynamic-pools--pool-name-.md): Adds and/or removes IPs to/from the specified dynamic IP pool.
A given pool is required to have at least 1 IP that is not
actively warming. Additionally, a single IP cannot be assigned to
multiple dynamic pools.

## List all domains assigned to dynamic IP pools

 - [GET /v1/dynamic_pools/domains](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/get-v1-dynamic-pools-domains.md): Retrieves all domains enrolled in dynamic IP pools across the parent account and subaccounts.

## Preview domain assignment

 - [GET /v1/dynamic_pools/domains/{name}/preview](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/get-v1-dynamic-pools-domains--name--preview.md): Runs a health check on a domain and returns which pool it would be placed in. It does NOT enroll the domain or set the band

## List domain history

 - [GET /v1/dynamic_pools/domains/{name}/history](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/get-v1-dynamic-pools-domains--name--history.md): Retrieves a domain's history records

## Override domain assignment

 - [PUT /v1/dynamic_pools/domains/{name}/override](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/put-v1-dynamic-pools-domains--name--override.md): Overrides a domain's dynamic IP pool assignment. A domain's pool will not be updated by health checks while an override is present.

## Remove override

 - [DELETE /v1/dynamic_pools/domains/{name}/override](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/delete-v1-dynamic-pools-domains--name--override.md): Removes any dynamic IP pool override for a domain. The domain's pool assignment will be managed by health checks.

## List account history

 - [GET /v1/dynamic_pools/history](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/dynamic-ip-pools/get-v1-dynamic-pools-history.md): Retrieve history records for all domains assigned to Dynamic IP Pools across the parent and subaccounts.