---
title: "Create Subaccount"
method: POST
path: "/subaccounts"
tags: ["Subaccount APIs"]
---

# Create Subaccount

`POST /subaccounts`

**Creates a subaccount under your master account.** Subaccounts function like regular Email API accounts but are credit-controlled by the master account. By default, subaccounts have "unlimited" credit access from the master. To restrict usage, set `credit_type` to `one_time_credit` and allocate credits manually or on a recurring schedule. A confirmation email is sent to the provided address. If no password is set, the confirmation link also serves as a password setup link.

## Headers

- `Authorization` string, required

## Request body

- object
  - `username` string, required — The username for the subaccount. Must be unique under the master account
  - `email` string, required — The email address associated with the subaccount
  - `password` string, required — The password for the subaccount
  - `credit_type` 'unlimited' | 'one_time_credit' — The credit allocation type. Can be either unlimited or one_time_credit. Default is one_time_credit

## Response `200`

Subaccount created successfully

- object
  - `message` string
  - `api_key` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

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