v1

latestOpenAPI 3.1.02026-07-2616459400.5 KB

IP Management API

Request New Dedicated IP Addresses

This allows a parent account to request additional dedicated IPs for email sending. The request specifies the number of IPs required, the estimated daily sending volume, the region, and an optional description.

post/ip/request

Request body

requested_ipsinteger required

The number of dedicated IP addresses being requested. Minimum 1, maximum 100 per request.

daily_estimated_volumeinteger required

The estimated daily email volume (number of emails per day) that the requested IPs will be used for.

region'US' | 'EU' | 'IND'

The geographic region where the IPs should be provisioned. Supported values are US, EU, and IND.

descriptionstring

A short description of the intended IP usage. Maximum length 255 characters and alphanumeric text only.

enableWarmupboolean

Indicates whether to enable the automated IP warm-up process. Values are true (enable warmup) or false (disable warmup).When enabled, the warmup logic assigns the appropriate plan based on engagement, bounce behavior, and unsubscribes. The delivery engine increases send volumes gradually using ISP feedback and performance signals to reduce throttling and spam-filtering risk. Netcore manages the full warmup process. Approved volume is sent through the assigned dedicated IP pool, and any excess volume is routed through the Netcore or client shared pool.

Example request

{
  "requested_ips": 5,
  "daily_estimated_volume": 10000,
  "region": "US",
  "description": "Additional IPs for marketing campaigns",
  "enableWarmup": true
}

Response

IP request submitted successfully

statusstring

request_idstring

Unique request identifier

messagestring

Example response

{
  "status": "Success",
  "request_id": "IP-REQ-2024-001-ABC123",
  "message": "IP request submitted successfully"
}