---
title: "Allocate Domain to Subaccount"
method: POST
path: "/domains/allocate"
tags: ["Domain APIs"]
---

# Allocate Domain to Subaccount

`POST /domains/allocate`

This API assigns an existing domain to a specific sub-account within your CPaaS environment.
Ensure the domain is already created and unallocated before invoking this endpoint. Each domain can be associated with only one sub-account at a time.
You must have valid credentials and the necessary permissions to allocate domains to sub-accounts.

## Headers

- `Accept` string, required
- `Content-Type` string, required

## Request body

- object
  - `subaccount_username` string, required — Username of the sub-account to which the domain will be allocated.
  - `domain_name` string, required — Fully qualified domain name to be allocated.

## Response `200`

Domain successfully allocated.

## Other responses

- `400` — Bad Request – The domain is already assigned to another sub-account.
- `403` — Forbidden – The sub-account is invalid or you are not authorized to perform this action.
- `404` — Not Found – The specified domain does not exist in your account.

---

[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)