SendGrid can automatically warmup dedicated IP addresses by limiting the amount of mail that can be sent through them per hour. This section allows you to use the API to create IP pools, assign IP addresses to them, and enable IP warmup pools and the IPs within pools.

Learn more about automated IP warmup here.


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)