Skip to content

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.

Operations

Enroll domain

Request

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.

Security
basicAuth
Path
namestringrequired

Domain name

Query
replacement_ipstringrequired

A valid IP address or 'shared'

curl -i -X POST \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v3/domains/{name}/dynamic_pools?replacement_ip=string'

Responses

A 200 response

Bodyapplication/json
messagestringrequired

Response message

Response
{
  "message": "success"
}