---
title: "Add a subaccount"
method: POST
path: "/subaccount/add"
tags: ["SUBACCOUNTS"]
---

# Add a subaccount

`POST /subaccount/add`

Adds a new subaccount on your master account.<strong> Note:</strong> This end-point is rate limited to 50 calls per hour.

## Request body

- object
  - `fullname` string, required — A full name used for the subaccount
  - `subaccount_email` string — An optional email address for the first team member in the subaccount. An email invitation will be sent to this address.
  - `limit` integer — The number of emails the subaccount is allowed to send per billing cycle. <br><br><strong>Valid values:</strong><br>2000, 5000, 10000, 20000, 30000, 40000, 50000, 60000, 80000, 100000, 250000, 500000, 1000000, 2000000, 3000000, 5000000, 10000000
  - `dedicated_ip` boolean — Auto assign a dedicated IP to the subaccount (Only available if limit is greater than 100,000)
  - `archiving` boolean — Choose whether the subaccount is allowed to enable archiving. You still need to turn on archiving for individual senders within the subaccount.
  - `enforce_2fa` boolean — Enforce team members of this subaccount to use 2FA.
  - `enable_sms` boolean — Enable SMS messaging for the subaccount. Additional charges apply.
  - `sms_limit` integer — Your subaccount will be able to send up to this monthly limit of SMS messages. Their sending will also be limited by the master account's overall monthly limit.

## Response `200`

Subaccount added

- object
  - `request_id` string, required
  - `data` object, required
    - `name` string, required
    - `id` string, required
    - `plan_size` integer, required
    - `plan_used` integer, required
    - `plan_remaining` integer, required
    - `state` string, required
    - `dedicated_ip` boolean, required
    - `archiving` boolean, required
    - `enforce_2fa` boolean, required
    - `sms_enabled` boolean, required
    - `sms_limit` integer, required

## Other responses

- `400` — 400

---

[API](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4.md) · [All operations](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smtp2go/smtp2go-api-v3-0-4/revisions/1ba6b25eebb9/schema)