On this page

Start warming up an IP address

API Overview

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.

Operation overview

POST/v3/ips/warmup

Base url: https://api.sendgrid.com (for global users and subusers)

Base url: https://api.eu.sendgrid.com (for EU regional subusers)

This endpoint allows you to put an IP address into warmup mode.

Operation details

Authentication

API Key

Headers

Property nameTypeRequiredDescription

Authorizationstringrequired

Default: Bearer <<YOUR_API_KEY_HERE>>

Request body

Encoding type:application/json

SchemaExample

Property nameTypeRequiredDescriptionChild properties

ipstringOptional

The IP address that you want to begin warming up.

Responses

200404

SchemaExample

Array of:

Property nameTypeRequiredDescriptionChild properties

ipstring

The IP address.

start_dateinteger

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

Start warming up an IP address

1const client = require("@sendgrid/client");
2client.setApiKey(process.env.SENDGRID_API_KEY);
3
4const data = {
5  ip: "0.0.0.0",
6};
7
8const request = {
9  url: `/v3/ips/warmup`,
10  method: "POST",
11  body: data,
12};
13
14client
15  .request(request)
16  .then(([response, body]) => {
17    console.log(response.statusCode);
18    console.log(response.body);
19  })
20  .catch((error) => {
21    console.error(error);
22  });