POST


Add an IP to a pool.

An IP may belong to multiple pools. It may take 60 seconds for your IP
address to be added to a pool after your request is made.

URI Parameter Required Requirements Description
ip Yes Valid IP address IP address to add to the pool

Request

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

Response

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

{
"ip": "000.00.00.0",
"pools": [
"test1"
],
"start_date": 1409616000,
"warmup": true
}

GET

See a list of all assigned and unassigned IPs. Response includes warm up status, pools, assigned subusers, and whitelabel info. The start_date field corresponds to when warmup started for that IP.

Request

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

Response

1
2
3
4
5
6
7
8
9
10
11
12
HTTP/1.1 200 OK

[
  {
    "ip":"000.00.00.0",
    "warmup":true,
    "start_date":1409616000,
    "subusers": ["username1", "username2"],
    "rdns": "01.email.test.com",
    "pools": ["pool1", "pool2"]
  }
]

GET

See only assigned IPs.

Request

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

Response

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

[
  {
    "ip":"167.89.21.3",
    "pools":["new_test5"],
    "warmup":true,
    "start_date":1409616000,
  }
]

GET


See which pools an IP address belongs to.

Request

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

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
HTTP/1.1 200 OK 

{
  "ip": "000.00.00.0",
  "subusers": [
    "subuser1",
    "subuser2"
  ],
  "rdns": "o1.em.example.com",
  "pools": ["test1"],
  "warmup": false,
  "start_date": null,
  "whitelabeled": true
}

DELETE


Remove an IP address from a pool.

Request

1
DELETE https://api.sendgrid.com/v3/ips/pools/:pool_name/ips/:ip HTTP/1.1

Response

1
HTTP/1.1 204 NO CONTENT (OK)