---
title: "Assign pools to Subaccount"
method: POST
path: "/ip/pool/subaccount/assign-pools"
tags: ["IP Management API"]
---

# Assign pools to Subaccount

`POST /ip/pool/subaccount/assign-pools`

This allows a parent account to manage which IP pools are available to a subaccount. You can add new pools or remove existing ones from a subaccount, ensuring that eacg subaccount has the correct set of IP pools for its sending need.

## Request body

- object
  - `account` string, required — The username of the subaccount to which pools will be assigned or removed. The subaccount must exist and belong to the authenticated parent account.
  - `sending_domain` string, hostname, required — The domain associated with the subaccount. This must be a valid domain owned by the account and is used to link pool assignments to the correct sending domain.
  - `pools_to_add` string[] — A list of pool names to assign to the subaccount. Maximum of 10 pools per request. Each pool must exist, belong to the parent account, and not already be assigned to the subaccount.
  - `pools_to_remove` string[] — A list of pool names to remove from the subaccount. Maximum of 10 pools per request. Each pool must currently be assigned to the subaccount.

## Response `200`

Pools assigned successfully

- object
  - `status` string
  - `message` string
  - `result` object
    - `account` string
    - `assigned_pools` string[]
    - `updated_on` string, date-time

## Other responses

- `400` — Validation error
- `401` — Authentication required
- `403` — Access forbidden or ownership validation failed

---

[API](https://skmtc.dev/netcorecloud/apis/email-api-v6.md) · [All operations](https://skmtc.dev/netcorecloud/apis/email-api-v6/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netcorecloud/email-api-v6/revisions/73f83bc2eff8/schema)