Menu

IP Warmup

IP warming is the practice of gradually increasing the volume of mail sent with a dedicated IP address according to a predetermined schedule. This gradual process helps to establish a reputation with ISPs (Internet Service Providers) as a legitimate email sender.

SendGrid can automatically warm up dedicated IP addresses by limiting the amount of mail that can be sent through them per hour. The limit determined by how long the IP address has been warming up.

See the warmup schedule to learn how SendGrid limits your email traffic for IPs in warmup.

You can also choose to use Twilio SendGrid's automated IP warmup for any of your IPs from the "IP Addresses" settings menu in the Twilio SendGrid App.

Retrieve the warmup status for a specific IP address

Retrieve the warmup status for a specific IP address

GET /ips/warmup/{ip_address}

This endpoint allows you to retrieve the warmup status for a specific IP address.

You can retrieve all of your warming IPs using the "Retrieve all IPs currently in warmup" endpoint.

Authentication

  • API Key

Headers

Authorization
string
default: Bearer <<YOUR_API_KEY_HERE>>
required

Path Parameters

ip_address
string

The IP address that you want to retrieve the warmup status for.

required

Responses

array[object]
ip
string

The IP address.

start_date
integer

A Unix timestamp indicating when the IP address entered warmup mode.

[
  {
    "ip": "0.0.0.0",
    "start_date": 1409616000
  }
]
object
errors
array[object]

The errors that were encountered.

field
null
message
string

A message explaining why the warmup status could not be retrieved.

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.