The 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. More details about each operation can be found in the descriptions and schemas for each endpoint.
(warning)
Warning
The IP Address Management API is in public beta at this time. This means the API and documentation are still in development and subject to change without advanced notice.
Operation overview
PATCH/v3/send_ips/ips/{ip}
Base url: https://api.sendgrid.com
This operation updates an IP address's settings, including whether the IP is set to warm up automatically, if the IP is assigned by a parent account, and whether the IP is enabled or disabled. The request body must include at least one of the is_auto_warmup, is_parent_assigned, or is_enabled fields.
Operation details
Authentication
Headers
Property nameTypeRequiredDescription
Authorizationstringrequired
Default: Bearer <<YOUR_API_KEY_HERE>>
Path parameters
Property nameTypeRequiredDescription
ipstringrequired
The ip path parameter specifies an IP address to make the request against.
Indicates if the IP address is set to automatically warmup.
is_parent_assignedbooleanOptional
Indicates if a parent on the account is able to send email from the IP address.
is_enabledbooleanOptional
Indicates if the IP address is billed and able to send email. This parameter applies to non-Twilio SendGrid APIs that been added to your Twilio SendGrid account. This parameter's value is null for Twilio SendGrid IP addresses.