Dedicated IPs

Map an SES dedicated IP to your tenant. Routes sends through the right configuration set + IP pool.

How it works

AWS SES handles the actual IP provisioning ($24.95/mo per IP). You then register the IP with Mailgrid so the send path routes through it:

1. Provision the IP and create an IP pool in AWS SES.
2. Create an SES configuration set bound to that pool.
3. Call POST /api/ips with the IP address, pool name, and config set.
4. Mailgrid's send() auto-routes via the active pool when no streamId override is specified.

Register an IP

Scopes: ips:write

{
  "ipAddress": "54.240.7.123",
  "poolName":  "transactional-pool",
  "configSet": "inboxos-prod"
}

List IPs

Update status / warmup

{
  "status":    "warming",
  "warmupPct": 25
}

Status values: pending → warming → active → retired.

Recommended warmup ramp

Delete

Removes only the Mailgrid mapping — the SES IP still costs $24.95/mo until you release it in the AWS console.