SendGrid

SendGrid IP Address Management API

Twilio SendGrid IP Address Management API

Documentation GitHub OpenAPI

Operations 15

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v3/send_ips/ips List the IP addresses on my account · Get a List of all IP Addresses on your Account #

Ask an LLM

“Which sending IPs are on my account and which pools are they in?”

“Can I filter my IP list to only leased or only enabled addresses?”

Tell an agent

List every sending IP address on my account.

List my IPs in pool {pool}, {limit} at a time.

POST /v3/send_ips/ips Add a dedicated IP address · Add a Twilio SendGrid IP Address #

Ask an LLM

“How do I add a new dedicated IP address to my account?”

“Can I assign subusers to an IP at the moment I add it?”

Tell an agent

Add a new IP with auto warmup {is_auto_warmup} and parent assignment {is_parent_assigned}.

Add an IP in region {region}, auto warmup {is_auto_warmup}, parent assigned {is_parent_assigned}, for subusers {subusers}.

GET /v3/send_ips/ips/{ip} Get details for one IP address · Get Details for an IP Address #

Ask an LLM

“Is a particular IP leased, warming up automatically, or assigned to the parent?”

“When was a specific sending IP added and last modified?”

Tell an agent

Get the details for IP {ip}.

Show IP {ip} including its region: {include_region}.

PATCH /v3/send_ips/ips/{ip} Update an IP address's settings · Update Details for an IP Address #

Ask an LLM

“Can I turn off automatic warmup for one of my IPs?”

“What settings on an IP can I switch, like enabled or parent-assigned?”

Tell an agent

Set auto warmup to {is_auto_warmup} on IP {ip}.

Disable or enable IP {ip}: set enabled to {is_enabled}.

GET /v3/send_ips/ips/{ip}/subusers List subusers assigned to an IP · Get a List of Subusers Assigned to an IP #

Ask an LLM

“Which subusers are allowed to send from a given IP?”

“Can I page through the subuser IDs on an IP with a limit?”

Tell an agent

List the subusers assigned to IP {ip}.

Show up to {limit} subuser IDs on IP {ip}.

POST /v3/send_ips/ips/{ip}/subusers:batchAdd Assign subusers to an IP in bulk · Assign a Batch of Subusers to an IP #

Ask an LLM

“How do I give several subusers access to one IP in a single request?”

“What happens if one subuser in the batch can't be assigned to the IP?”

Tell an agent

Assign subusers {subusers} to IP {ip}.

Batch add these subusers to IP {ip}: {subusers}.

POST /v3/send_ips/ips/{ip}/subusers:batchDelete Unassign subusers from an IP in bulk · Delete a Batch of Subusers from an IP #

Ask an LLM

“Can I remove a batch of subusers from an IP at once?”

“Which call takes several subusers off a dedicated IP?”

Tell an agent destructive · confirm first

Remove subusers {subusers} from IP {ip}.

Unassign this batch of subusers from IP {ip}: {subusers}.

GET /v3/send_ips/pools List IP pools with a sample of their IPs · GET all IP Pools that have Associated IPs #

Ask an LLM

“What IP pools do I have and which IPs are in each?”

“Can I find which pools contain a specific IP?”

Tell an agent

List all my IP pools.

Show the IP pools that include IP {ip}.

POST /v3/send_ips/pools Create an IP pool · Create an IP Pool with a Name and IP Assignments #

Ask an LLM

“How do I create a named IP pool and put IPs in it?”

“Does creating a pool fail if one of the IP assignments fails?”

Tell an agent

Create an IP pool named {name}.

Create IP pool {name} containing IPs {ips}.

GET /v3/send_ips/pools/{poolid} Get details for an IP pool · Get Details for an IP Pool #

Ask an LLM

“How many IPs belong to a particular IP pool?”

“What does SendGrid tell me about a single pool, like its name and sample IPs?”

Tell an agent

Get the details of IP pool {poolid}.

Show pool {poolid} with regions included: {include_region}.

PUT /v3/send_ips/pools/{poolid} Rename an IP pool · Update an IP Pool Name #

Ask an LLM

“Can I rename an existing IP pool?”

“Are there naming rules for an IP pool, like no leading dot or space?”

Tell an agent

Rename IP pool {poolid} to {name}.

Change pool {poolid}'s name to {name}.

DELETE /v3/send_ips/pools/{poolid} Delete an IP pool · Delete IP Pool #

Ask an LLM

“If I delete an IP pool, do its IP addresses stay on my account?”

“How do I get rid of an IP pool entirely?”

Tell an agent destructive · confirm first

Delete IP pool {poolid}.

Remove pool {poolid} and unassign all of its IPs.

GET /v3/send_ips/pools/{poolid}/ips List all IPs in an IP pool · Get IPs Assigned to an IP Pool #

Ask an LLM

“Which IP addresses are assigned to a given pool, beyond the sample?”

“Can I page through every IP in one pool?”

Tell an agent

List every IP assigned to pool {poolid}.

Show {limit} IPs from pool {poolid}.

POST /v3/send_ips/pools/{poolid}/ips:batchAdd Add IPs to an IP pool in bulk · Add a Batch of IPs to an IP Pool #

Ask an LLM

“Can I add several IPs to an existing pool in one request?”

“What happens if one IP in a batch can't be added to the pool?”

Tell an agent

Add IPs {ips} to pool {poolid}.

Batch assign these IPs to IP pool {poolid}: {ips}.

POST /v3/send_ips/pools/{poolid}/ips:batchDelete Remove IPs from an IP pool in bulk · Delete a Batch of IPs from an IP Pool #

Ask an LLM

“Does removing IPs from a pool also remove them from my account?”

“How do I take a batch of addresses out of one IP pool?”

Tell an agent destructive · confirm first

Remove IPs {ips} from pool {poolid}.

Unassign this batch of IPs from IP pool {poolid}: {ips}.

Documentation

https://www.twilio.com/docs/sendgrid/api-reference/account-provisioning

https://www.twilio.com/docs/sendgrid/api-reference/alerts

https://www.twilio.com/docs/sendgrid/api-reference/api-keys

https://www.twilio.com/docs/sendgrid/api-reference/domain-authentication

https://www.twilio.com/docs/sendgrid/api-reference/email-activity

https://www.twilio.com/docs/sendgrid/api-reference/email-address-validation

https://www.twilio.com/docs/sendgrid/api-reference/enforced-tls

https://www.twilio.com/docs/sendgrid/api-reference/sendgrid-integrations

https://www.twilio.com/docs/sendgrid/api-reference/ip-access-management

https://www.twilio.com/docs/sendgrid/api-reference/ip-address-management-api

https://www.twilio.com/docs/sendgrid/api-reference/ip-warmup

https://www.twilio.com/docs/sendgrid/api-reference/ip-address

https://www.twilio.com/docs/sendgrid/api-reference/link-branding

https://www.twilio.com/docs/sendgrid/api-reference/campaigns-api

https://www.twilio.com/docs/sendgrid/api-reference/contacts-api-custom-fields

https://www.twilio.com/docs/sendgrid/api-reference/sender-identities-api

https://www.twilio.com/docs/sendgrid/api-reference/mail-settings

https://www.twilio.com/docs/sendgrid/api-reference/mail-send

https://www.twilio.com/docs/sendgrid/api-reference/contacts

https://www.twilio.com/docs/sendgrid/api-reference/custom-fields

https://www.twilio.com/docs/sendgrid/api-reference/designs-api

https://www.twilio.com/docs/sendgrid/api-reference/lists

https://www.twilio.com/docs/sendgrid/api-reference/segmenting-contacts-v2

https://www.twilio.com/docs/sendgrid/api-reference/segmenting-contacts

https://www.twilio.com/docs/sendgrid/api-reference/senders

https://www.twilio.com/docs/sendgrid/api-reference/single-sends

https://www.twilio.com/docs/sendgrid/api-reference/marketing-campaign-stats

https://www.twilio.com/docs/sendgrid/api-reference/send-test-email

https://www.twilio.com/docs/sendgrid/api-reference/partner-settings

https://www.twilio.com/docs/sendgrid/api-reference/recipients-data-erasure

https://www.twilio.com/docs/sendgrid/api-reference/reverse-dns

https://www.twilio.com/docs/sendgrid/api-reference/cancel-scheduled-sends

https://www.twilio.com/docs/sendgrid/api-reference/api-key-permissions

https://www.twilio.com/docs/sendgrid/api-reference/sendgrid-engagement-quality-api

https://www.twilio.com/docs/sendgrid/api-reference/single-sign-on-settings

https://www.twilio.com/docs/sendgrid/api-reference/stats

https://www.twilio.com/docs/sendgrid/api-reference/subusers-api

https://www.twilio.com/docs/sendgrid/api-reference/suppressions-unsubscribe-groups

https://www.twilio.com/docs/sendgrid/api-reference/teammates

https://www.twilio.com/docs/sendgrid/api-reference/transactional-templates

https://www.twilio.com/docs/sendgrid/api-reference/settings-tracking

https://www.twilio.com/docs/sendgrid/api-reference/users-api

https://www.twilio.com/docs/sendgrid/api-reference/sender-verification

https://www.twilio.com/docs/sendgrid/api-reference/webhooks

Specifications

https://raw.githubusercontent.com/api-evangelist/sendgrid/refs/heads/main/openapi/sendgrid-ip-address-management-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/sendgrid-ip-address-management-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Twilio SendGrid IP Address Management API
  summary: The Twilio SendGrid IP Address Management API combines functionality that was previously split between the Twilio SendGrid IP Address API and IP Pools API, including adding IP addresses to your account, assigning IP addresses to IP Pools and Subusers, among other tasks.
  description: The Twilio SendGrid IP Address Management API combines functionality that was previously split between the Twilio SendGrid IP Address API and IP Pools API. This functionality includes adding IP addresses to your account, assigning IP addresses to IP Pools and Subusers, among other tasks.
  termsOfService: https://www.twilio.com/legal/tos
  contact:
    name: Twilio SendGrid Support
    url: https://support.sendgrid.com/hc/en-us
  license:
    name: MIT
    url: https://code.hq.twilio.com/twilio/sendgrid-oas/blob/main/LICENSE
  version: 1.0.0
  x-sendgrid:
    libraryPackage: ip_address_management
servers:
- url: https://api.sendgrid.com
  description: for global users and subusers
- url: https://api.eu.sendgrid.com
  description: for EU regional subusers
security:
- BearerAuth: []
tags:


# --- truncated at 32 KB (74 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sendgrid/refs/heads/main/openapi/sendgrid-ip-address-management-api-openapi.yml