IP Address Management API
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.
Add a Twilio SendGrid IP Address
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.
POST /v3/send_ips/ips
Base url: https://api.sendgrid.com
This operation adds a Twilio SendGrid IP address to your account. You can also assign up to 100 Subusers to the IP address at creation.
Request Body
Indicates if a parent on the account is able to send email from the IP address.
An array of Subuser IDs the IP address will be assigned to.
maxItems: 100The region of the IP address. Can be eu or us. (Regional email is in Public Beta and requires SendGrid Pro plan or above.)
Boolean indicating whether or not to return the IP address's region information in the response. (Regional email is in Public Beta and requires SendGrid Pro plan or above.)
default: FalseResponses
The IP address that was added to your account.
Indicates if the IP address is set to automatically warmup. This parameter is returned only if the IP address is set to automatically warm up.
Indicates if a parent on the account is able to send email from the IP address.
An array of Subuser IDs the IP address was assigned to.
The region of the IP address. This is only returned if include_region is set to True in the API request.
IP Address Management Error Response Schema
An array of error objects.
Indicates which field caused the error. This may be an empty string if no specific field is responsible for the error.
An error-specific message that provides more information about the error's cause.
IP Address Management Error Response Schema
An array of error objects.
Indicates which field caused the error. This may be an empty string if no specific field is responsible for the error.
An error-specific message that provides more information about the error's cause.
IP Address Management Error Response Schema
An array of error objects.
Indicates which field caused the error. This may be an empty string if no specific field is responsible for the error.
An error-specific message that provides more information about the error's cause.
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.
