Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Create an IP pool



API Overview

api-overview page anchor

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 determined by the aggregate performance of all email traffic sent from 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 100 different IP pools.


POST/v3/ips/pools

Base url: https://api.sendgrid.com

This endpoint allows you to create an IP pool.

Before you can create an IP pool, you need to activate the IP 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.

Authentication

authentication page anchor
Authorizationstringrequired
Default: Bearer <<YOUR_API_KEY_HERE>>
SchemaExample
namestringrequired

The name of your new IP pool.

Max length: 64
200
SchemaExample
namestring

The name of the IP pool.

Create an IP pool

create-an-ip-pool page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
curl

_21
const client = require('@sendgrid/client');
_21
client.setApiKey(process.env.SENDGRID_API_KEY);
_21
_21
const data = {
_21
"name": "marketing"
_21
};
_21
_21
const request = {
_21
url: `/v3/ips/pools`,
_21
method: 'POST',
_21
body: data
_21
}
_21
_21
client.request(request)
_21
.then(([response, body]) => {
_21
console.log(response.statusCode);
_21
console.log(response.body);
_21
})
_21
.catch(error => {
_21
console.error(error);
_21
});


Rate this page: