Menu

IP Pools

IP pools allow you to group your dedicated SendGrid IP addresses. For example, you could create separate one pool for your transactional email and another for your marketing email. When sending marketing emails, specify that you want to use the marketing IP pool. This allows you to maintain separate reputations for your different email traffic.

A single IP address or a range of IP addresses may be dedicated to an account in order to send email for multiple domains. The reputation of this IP is based on the aggregate performance of all the senders who use it.

IP pools can only be used with IP addresses for which you’ve set up a reverse DNS record.

If an IP pool is not specified for an email, it will use any IP available, including pooled addresses.

Each user can create up to 10 different IP pools.

Add an IP address to a pool

Add an IP address to a pool

POST /ips/pools/{pool_name}/ips

This endpoint allows you to add an IP address to an IP pool.

You can add the same IP address to multiple pools. It may take up to 60 seconds for your IP address to be added to a pool after your request is made.

Before you can add an IP to a pool, you need to activate it in your SendGrid account:

  1. Log into your SendGrid account.
  2. Navigate to Settings and then select IP Addresses.
  3. Find the IP address you want to activate and then click Edit.
  4. Check Allow my account to send mail using this IP address.
  5. Click Save.

You can retrieve all of your available IP addresses from the "Retrieve all IP addresses" endpoint.

Authentication

  • API Key

Headers

Authorization
string
default: Bearer <<YOUR_API_KEY_HERE>>
required

Request Body

object
ip
string

The IP address that you want to add to the named pool.

{
  "ip": "0.0.0.0"
}

Path Parameters

pool_name
string

The name of the IP pool you want to add the address to. If the name contains spaces, they must be URL encoded (e.g., "Test Pool" becomes "Test%20Pool").

required

Responses

object
ip
string

The IP address.

required
pools
array[string]

The IP pools that this IP address has been added to.

required
start_date
integer

A Unix timestamp indicating when the warmup process began for the added IP address.

required
warmup
boolean

Indicates if the IP address is in warmup.

required
object
errors
array[object]

The error returned.

field
null
message
string

A message explaining why the IP address could not be added to the IP Pool.

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.