Assign IPs to subaccount

This allows a parent account to allocate one or more dedicated IP addresses to a subaccount by linking them with a specified sending domain. This ensures that the subaccount can send emails using the assigned IPs. The request must include the subaccount name, sending domain, and IP addresses, with all IPs belonging to the same region and owned by the parent account.

Body Params
assignments
array of objects
required
length between 1 and 10

A list of assignment objects. Each obejct defines the mapping of one or more IP addresses to a specific subaccount and domain. You can send 1 to 10 assignments per request.

assignments*
ip_address
array of strings
required
length between 1 and 100

The dedicated IP addresses to assign to the subaccount. Must be valid IPs owned by the parent account. Atleast one IP is required; up to 100 can be included per assignment. All IPs must belong to the same region.

ip_address*
string
required

The Subaccount username that will receive the IPs. The subaccount must exit and belong to the authenticated parent account. Used to ensure the assignment is correctly linked.

string
required

The domain that the subaccount will use with the assigned IPs. Must be an active, valid domain associated with the subaccount. Ensures email authentication and reputation are tied to the correct domain.

string
enum

The geographic region of the IP addresses being assigned. Supported values are US, EU, IND. If provided, all IPs in the assignment must match the region.

Allowed:
Responses

Language
Credentials
Bearer
URL
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json