SendGrid can automatically warmup dedicated IP addresses by limiting the amount of mail that can be sent through them per hour, with the limit determined by how long the IP address has been in warmup. See the warmup schedule for more details.

If you have existing warm IPs as well as new IPs that need warming, any mail beyond the hourly maximum limit will overflow to your existing warm IPs.

If there are no existing warm IPs, any requests made above the hourly maximum limit will overflow to our Shared IP Warmup clusters for sending. If your sending reputation is below 85, you will not be able to use these Shared IP Warmup clusters.

An IP in warmup will always follow SendGrid’s Warmup Schedule. Please consider a measured approach when sending on a new IP to allow for proper IP warmup. You can read more on the importance of warming up a new IP and consider your sending volume for best deliverability.


GET

Get all IPs that are currently warming up. The value returned for “start_date” represents the date that the IP was entered into warmup, and is always formatted as a Unix timestamp.

Request

1
GET https://api.sendgrid.com/v3/ips/warmup HTTP/1.1

Response

1
2
3
4
5
6
7
8
HTTP/1.1 200 OK

[
  {
    "ip": "0.0.0.0",
    "start_date": 1409616000
  }
]

GET

Get warmup status for a particular IP.

URI Parameter Required Requirements Description
ip Yes Valid IP address IP address for which to retrieve status

Request

1
GET https://api.sendgrid.com/v3/ips/warmup/:ip_address HTTP/1.1

Response

1
2
3
4
5
6
7
8
HTTP/1.1 200 OK

[
  {
    "ip":"0.0.0.0",
    "start_date":1409616000
  }
]

POST

Add an IP to warmup.

URI Parameter Required Requirements Description
ip true A valid IP address. The IP address to warmup.

Request

1
POST https://api.sendgrid.com/v3/ips/warmup HTTP/1.1

Response

1
2
3
4
5
6
7
8
HTTP/1.1 201 OK

[
  {
    "ip":"0.0.0.0",
    "start_date":1409616000
  }
]

DELETE

Remove an IP from warmup.

Request

1
DELETE https://api.sendgrid.com/v3/ips/warmup/0.0.0.0 HTTP/1.1

Response

1
HTTP/1.1 204 NO CONTENT (OK)